SOFTWARE NOTE Honeywell Baal 


Software Maintenance 


Dote Nov. 1975 1 | Reference Number 32/8/361 


Author R, Susman Status 


Customer / Dept. Submitted by 
os EDOS / ETOS* Release ET 025 Program 


VERTEILUNG NEUE SOFIWARE VERSION 


Wie Sie aus dem High light BT 025 ersehen kénnen, gelangt eine 
neue Software Version demnadchst zur Verteilung. 


Wir méchten Sie deshalb bitten, eine Disk Pack fiir die Aufnahme 
des neven Programmfiles in der Grésse von mindestens 120 
Zylindern vorzubereiten. 


Wir werden uns in niachster Zeit mit Ihnen in Verbindung setzen, 
um eien Termin ftir die Ueberspielung der Version 25 zu verein- 


baren. v 
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ORDRES POUR LA DUPLICATION ET LE TRANSFERT D' INFORMATIONS 


Bande magnétique-disque, disque-bande magnétique, disque-disque. 


« BOTT (BASIC DISC TO TAPE TRANSFER) 


Transfert du contenu du Basie dise sur bande. 


FONCTION : 


Exécute une copie intégrale de tout le Basic disc (cylindre 0, Fichier 
programme, fichiers données & l'exclusion d'une éventuclle zone libre a 
la fin du disque) sur une bande 9 voies préalablement immatricuiéa en 
800 ou 1600 bpi. 


CARTE ORDRE : 


« BOTT, ot ot = Numéro logique du dérouleur en sortie 


PARTICULARITES DU PROGRAMME 


4 ~ Le transfert des informations se fera piste par piste 
2 - Le ruban de sortie devra avoir un Label standard 


3 - Le transfert exécuté, la bande en sortie sera qutomatiquement 
contrélée au point de vue Formel 


MESSAGES : 


BD 800 * ORDER NOT EXECUTED. 
L'ordre est jianeé en biprogrammation 


L'exécution du programme s'arréte sur une halte O2AG avec condition 
dtexécution NON 


BD 802 * TAPE NOT CONNECTED. 


Le disque de base n'est pas personnalisé pour une configuration 
mixte (bandes disques) 


Liexécution du programme starréte sur une halte 02A6 avec 
condition dtexécution NON 


BD 803 * DISC TYPE UNKNOWN 


Dans l'étiquette de volume du disque de base, le contenu de la 
position qui indique le type de disque, est erront. 


Ltexéeution du programme s'arréte sur une halte 0246 avee 
condition d'exécution NON. 


B D 804* 7 TRACKS TAPE NOT ALLOWED. 


Le ruban en sortie est monté sur-un dérouleur 7 voies 


Liexécution du programme starréte sur une halte 02A6 avec condition 
d'texécution NON 
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BD 805 * TAPE LABEL FORMAL ERROR 
Le ruban en sortie nta pas un label standard. 


L'iexécution du programme starréte sur une halite O2A6 avec 
condition dlexécution NON 


B D 806 * OUTPUT TAPE CONTROL. ERROR 


Le contréle exécuté sur bande,aprés transcription, a rencontré 
des erreurs formelles. 


L'exécution du programme starr&te sur une halte O2A6 avec” 
condition dtexécution NON 


B D 809 * INPUT DISC FORMAL ERROR 


Durant la transcription, une erreur a &té relevée sur le 
disque de base. 


oO Liexécution du programme s'arréte sur une halte O2A6 avec 
condition d'exécution NON 


BD 810 * ORDER WRONG 


Le format de la carte ordre est erroné. L'exécution du programme 
starréte sur une halte O2AG6 avec condition d'exécution 4 NON 


BD 812 * INPUT DISC EMPTY 
Le disque de base ne contient aucun fichier (programme ou données) 


Liexécution du programme starréte sur une halte O2A6 avec 
condition d'exécution NON 


BD 999 * END OF . BDTT 


Ltordre s'est correctement exécuté. 


oO « DTYD (DISC TO WORK DISC TRANSFER) 


Transfert du contenu d'un disque sur work disc. 
FONCTION ; 


Exécute une copie intégrale de tout le disque en entrée (cylindre 
zéro, fichier programme, fichiers données, A ltexclusion dtune 


éventuelle zone libre A la fin du disque) sur un disque défini 
comme WD dans ltordre « INT 


CARTE ORDRE : 


» DTWD, ia id = Numéro logique de l'unité de disque 
en entrée. 


32006" 
28/10/75 


3/7 


PARTICULARITES DU PROGRAMME : 


1 - Les transferts entre différents type de disque ne 
sont pas admis. 


2 - Le transfert des informations steffectuera piste par piste. 


3 - Dans les systémes 4 deux disques seulement il donne la 
possibilité de transfert sur le work disque : soit le contenu 
du disque de base ou bien le contenu d'un quelcongue disque 
aprés ltavoir monté sur ltunité précédemment oscupée par la 
@isque de base. 


Le choix entre les deux options peut étre pris par Jtonératert 
aprés L'arrét par élaboration d'une halte OLFS et Ltimpressia: 
du message 001, Presser sur START dans le premier cas ou 

remplacer le disque avant de presset' START dans Le second can. 


4& - Durant la transcription, le disque en sortie sera automatique- 
ment contrélé ou point de vue erreur formelle. 


MESSAGES : 


DT 001 * AWAITING START IF VOLUME CHANGE 
AWAITING START IF VOLUME CHANGE IF NOT CLEAR START. 


Ces messages d'interrogations seront accompagnés d'une HALTE CifG. 
Le premier se référencie 4 la situation décrite au point 3. 

Le second sera émis 4 la fin de la transcription aprés ic 

message DT 999 et permet ou la transcription d'un autre disque 
(substitution d'un disque et presser START) ou bien le passage 

& une autre élaboration (presser CLEAR et START). 


DT 800 * ORDER NOT EXECUTED. 
Liordre est lancé en biprogrammation. 


L'exécution du programme s'arréte sur une halte O2A6 avec 
condition dtexécution NON. 


DT 801 * WD UNDEFINED 


WD non défini dans .INT - ltexécution du programme starréte sur 
une halte O2A6 avec condition d'texécution NON 


DT 603 * DISC TYPE UNKNOWN 


Dans l'tétiquette d'un des disques, le contenu de la position 
qui indique le type de disque est erroné. 


L'exécution du programme starr&te sur une halte O2A6 avec 
condition d'exécution NON, 


DT 807 * OUTPUT DISC FORMAL ERROR 


Le contréle exécuté sur disque durant la transcription, a 
rencontré des erreurs formelles. 


L'exécution du programme s'arréte sur une halte O2AG avec 
condition d'exécution NON, 
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DT 808 * ILLEGAL TYPE TRANSFER 


Le traitement demandé pour le transfert concerne des disques 
de type divers. 


L'exécution du programme starréte sur une halte O2A6 avec 
condition d'texécution NON. 


- DE 809 * INPUT DISC FORMAL ERROR 


Durant la transcription plusieurs erreurs ont été relevées sur 
le disque en entrée. 


L'exécution du programme s‘arréte sur une halte 0246 avec 
condition d'texécution NON. 


DT 810 * ORDER WRONG 
Le contenu de la carte ordre est erroné 


L'exécution du programme starréte sur une halte 0206 avec 
condition d'exécution NON. 


DT 811 * ID = OD ILLEGAL 


Le traitement demande la transcription d'un disque monté sur 
Liunité définie comme WD dans l'ordre . INT. L'exécution du 
programme s'arréte sur une halte 0246 avec condition d'exécution 
NON. 


DT 812 * INPUT DISC EMPTY 


Le disque en entrée ne contient aucun fichier (programme 
ou données). 


L'exécution du programme s'arréte sur une halte O2A6 avec 
condition d'exécution NON. 

DT 999 * END OF . DIWD 

L'iordre est exécuté correctement. 


« TID (TAPE TO WORK DISC TRANSFER) 


Transfert du contenu d'une bande sur work disc. 


FONCTION : Transfert le contenu d'une bande, obtenu en sortie a partir 


d'un programme ordre . BDTT ou . WOTT, sur un disque défini 
comme WD par l'ordre . INT 


CARTE ORDRE : 


+ TTWD, it ; it = numéro logique du dérouleur de 
bande en entrée. 


32006F 
28/10/75 


5/7 


PARTICULARITES DU PROGRAMME : 


et 


4+ Moyennant l'utilisation des ordres . BDTT/.WDTT et TTWD, 
il ntest pas possible de faire la transcription sur des disques 
de type divers avec une unique exception pour le transfert de 
DSU 160 sur DSU 157. Dans cet ultime cas il est nécessaire 
de se rappeler que les programmes qui Glaborent tes Fichiers 
Séquentiels indexés devront Gtre recompilés et que les Fichiers 
Séquentiels indexés devront &tre transcrits sur un autre volume 
avec regénération de liindex. Attention sur DSU 157 L*index 
occupe 2 cylindres. 


2-A la fin de la transcription du WD, l'ordre « SVYTR sera automati-~ 
quement exécuté. 11 transférera le superviseur du disque de 
base sur le disque obtenu en sorties. 


3 + Durant la transcription le disque en sortie sera nutomatiquement 
contrélé au point de vue Formel 


ESSASES + 
© sassases 
TTB0O * ORDER NOT EXECUTED. 
Liordre est lancé en biprogrammation 


L'exécution du programme s'arréte sur une halte O2A6 avec condition 
dtexécution NON. 


TT801 * WD UNDEFINED. 
Le WD nta pas été défini par l*ordre . INT 


Ltexécution du programme starréte sur une halte O2A6 avec condition 
atexécution NON 


7TT802 * TAPES NOT CONNECTED 


Le disque de base ntest pas personnalisé pour une configuration mixte 
*) {(bandes et disques) 


L'exécution du programme starréte sur une halte 02A6 avee condition 
dtexécution NON. 


TT 803 * DISC TYPE UNKNOWN 


Dans le label du volume du disque de base, Le contenu de la position 
qui indique le type de disque est erroné. 


Lrexécution du programme starréte sur une halte O2A6 avec condition 
dtexécution NON. 


TT BO4*7 TRACKS TAPE NOTALLOWED. 
La bande en entrée est montée sur un dérouleur 7 voies. 
L'exécution du programme starréte sur une hatte O2A6 avec condition 
dtexécution NON. 
3e006r 
20/10/75 


6 


TT 805 * TAPE LABEL FORMAL ERROR 
La bande en entrée n'a pas de label standard. 


Liexécution du programme s'arréte sur une halte O2AG avec condition 
d'exécution NON. 


TT 807 * OUTPUT DISC FORMAL ERROR 


Le contréle exécuté sur disque pendant la transcription a rencontré 
une erreur formelle. L'exécution du programme s'arréte sur une halte 
0ZA6 avec condition d'exécution NON. 


TT 808 *" ILLEGAL TYPE TRANSFER 


Le disque duquel est dérivé lu bende en entrée (.UDTT/.WOTT) est dtun 
type different de celui du disque en sortie. Liexécution du programme 
s'arréte sur une halte O2A6 avec condition d'exécution NON. 


TT 810 * ORDER WRONG 


Le contenu de la carte ordre est erroné - Liexécution du programme 
s'arréte sur une halte O2A6 avee condition dtexécution NON. 


- TT 999 * END OF. TIWD 


_L'ordre s'est exécuté correctement. 
i 
« WDTT (WORK DISC TO TAPE TRANSFER) 


fransfert le contenu du work disc sur bande magnétique. 
FONCTION + exécute une copie intégrale de tout le WORK DISC (cylindre 
zéro, fichier programme, fichiers donnges, & l’exclusion 


d'une éventuelle zone libre & la fin du disque) sur bande 
9 voies précedemment immatriculée avec densité B00 ou 1600 Bpi. 


CARTE ORDRE : 
» WDTT, ot ot = Numéro Logique du dérouleur en sortie. 
PARTICULARITES : 


1 - Le transfert des informations se fera piste par piste 
2 - La bande en sortie doit avoir un label standard. 


3 - Le transfert exécuté, la bande en sortie sera automatiquement 
contrélée au point de vue Formelle, 


MESSAGES : 


Wp 800 * ORDER NOT EXECUTED 


Ltordre est lancé en biprogrammation. L'exécution du programme starrét{: 
sur une halte 0246 avee condition d'exécution NON. 


WD 802 * TAPES NOT ACCEPTED. i 


Le disque de base n'est pas personnalisé pour une configuration mixte 
(bandeset disques) 


Liexécution du programme s'arréte sur une halte O2AG6 avec condition 
d'exécution NON. 32006F 
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WD 803 * DISC TYPE UNKNOWN 


Dans 1'étiquette du volume du disque de base le contenu de ta 
position qui indique le type de disque est erroné. L'exécution du 
Programme s'tarréte sur une halte 02A6 avec condition dtexécution NON, 


wD 804 * 7 TRACKS TAPE NOT ALLOWED 


La bande en sortie est montée surun dérouleur 7 voies - L'exécution 
du programme starréte sur une halte O2A6 avec condition d'exécution NO’ 


WD 805 * TAPE LABEL FORMAL ERROR 


La bande en sortie n'a pas de label standard. L'exécution du programme 
starr&éte sur une halte O2A6 avec condition d'exécution NON. 


WD 806 * OUTPUT TAPE CONTROL ERROR 


Le contréle exécuté sur bande, pendant la transcription, a rencontré 
des erreurs Formelles. L'exécution du programme s'arréte sur une 
O2A6 avec condition d'exécution NON, 


WD 809 * INPUT DISC FORMAL ERROR. 


Durant la transcription, plusieurs erreurs ont &té relovées sur le 
disque en entrée. 


Ltexécution du programme starréte sur une halite 02A6 avec condition 
dtexécution NON. 


WD 810 * ORDER WRONG 


Le contenu de la carte ordre est erroné. L'exécution du programme. 
starréte sur une halte O2A6 avec condition d'exécution NON. 


WD 612 * INPUT DISC EMPTY 
Le disque en entrée ne contient aucun Fichier (programme ou données) 


L'exécution du programme starréte sur une halte 02A6 avec condition 
dtexécution NON. 


WD 999 * END OF . WDTT 


Ltordre s'est exécuté correctement. 
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BESCHREIBUNG DER NEVEN PROGRAMME, DIE IN DER VERSION 
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INHALTSVERZEI CHNIS 
EDOS PROGRAMME 
Seite 
¥ .DCONV 
v .TCONT 
¢ @DT157 11 
¥ 9D157 13 
v »DDP157 15 
EDOS UNTERPROGRANMME 
YDTGGE 17 
YGGDTIE 19 
YEBCDY 21 
YGECDY 23 
YHONEY 25 
YGEHOY 27 


Ref, RS ET 025 


-DCONV 


1.i. 


1.3. 


«DCONV 


DISC CONVERTIERUNG 


Sichern von Dateien auf Band 


Allgemeines 

Dieses Programm wird zur Sicherung einer, mehrer oder 
aller Dateien einer Platte auf Band benutzt. 

Anruf 

Das Programm wird mit der Order .DCONV angerufen. 


Hardwarevoraussetzungen 
- zwei Platteneinheiten 
~ eine Bandeinheit 

- Kartenleser 

~ Drucker 


Beschreibung der Orderkarte 
Die Orderkarte hat folgenden Aufbau: 


-DCONV, ID=id, OT-ot, pk, Ven 


M6gliche | Bedeutung des | Bemerkungen 
Werte Feldes 


0-7 Bingabeplatte 
1-8 Ausgabeband 


K oder L| Schreibdichte 
K=1600 L=800 


alle Num.| Volume~Serie | Mit SWITCHL) 
Werte Nummer keine Kon- 
trolle 


26 


Es kann mit allen Plattenstationsmodellen gearbeitet werden 
( pst 110 / 150 / 160 / 162 / 157 ) 


Es kénnen 6 und 8 Bit-Dateien bearbeitet werden. 


Zusatzprogramme 


Auf der Basisplatte miss die Order SPVAUXM vorhanden sein. 


Ref. RS ET 025 


-DCONV 


Sale 


BeBe 


Bode 


Benutzungsgrundlagen 


Beschreibung der Detailkarten 


Ab Spalte 1 werden die Dateinamen (max. 12 Stellen) der zu 
sichernden Dateien abgelocht, fortlaufend ohne Zwischenraum 
nur getrennt.durch Komma. 


fn, fn, fry cee 

Reicht eine Detailkarte nicht aus, kann eine zweite oder dritte 
Karte angelegt werden. Es sind maximal 20 Dateinamen méglich, 
Als letzte Karte muss eine BEND - Karte folgen. 

Eingabe tiber Kartenleser 


ORDERKARTE 
END 


Es werden alle auf der Platte befindlichen Dateien, mit Over- 
flowzone und Indexvylinder, falls vorhanden, auf Band iiber- 
tragen. 


ORDERKARTE 
DETAILKARTE(N ) 
PEND 


Bs werden nur die in der Detailkarte angegebenen Dateien mit 
Overflowzone und Indexzylinder, falls vorhanden, auf Band 
tibertragen. 

Ausgabe 

Druckprotokol1 

Wenn eine Datei tibertragen ist, wird der DATEINAME mit Bele- 
gung Datei und die Meldung “UFBERTRAG BEENDET" ausgedruckt. 
Funktionslogik 


Es k6nnen jeweils nur Dateien von einer Platte auf ein Band 
gesichert werden. 


Das Band kann einen beliebigen Kennsatz aufweisen. 


Ref, RS EP 025 
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4. Fehlermeldungen 


4.1. Ausdruck auf Drucker 
" HDR ANZAHE OVERFLUW " 
In den Detailkerten sind mehr als 20 Dateinamen angegeben 
worden. 
"“ HDRigvese eeoeNICHT GEFUNDEN " 
Der in der Detailkarte angegebene DATEINAME warde avf der 
Platte nicht gefunden. 
" ORDERCARD WRONG " 
Fehlerhafte Orderkarte. 


4.2. Nicht blockierende Haltefalle mit Ausdruck 
Hit, 1111 mit Ausdruck " VN= ANGABE FEHLT " 


VN= Angebe in der Orderkarte fehlt. Wenn keine Priifung der 
Volume - Serie Nummer verlangt wird, kann mit SWITCH 1 
das Programm weitergefiihrt werden. 


H1lt. 1122 mit Ausdruck " FALSCHE VOL. NR. " 


VN= Angabde stimmt nicht mit der Fingebeplatte iiberein. 
Das Programm kenn mit SWITCH 1 weitergefiihrt werden. 


4.3. Blockierender Haltefall ohne Ausdruck 
H1t. OOOF 
Bandspule ist zu klein. 


Ref, RS BT 025 
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-TCONY TAPE CONVERTIERUNG 


Zurtickschreiben von gesicherten Dateien auf Platte. 
Allgemeines 


Dieses Programm wird bentitzt, um eine, mehrere oder alle 
Dateien, die durch @ie Order .DCONV auf Band gesichert 
wurden, auf eine Platte zurtickzuschreiben. 


1.1. Anruf 


Das Programm wird durch die Order .TCONV angerufen. 


1.2. Hardwarevoraussetzungen 


- zwei Platteneinheiten 
~ eine Bandeinheit 
- Kartenleser 


- Drucker 


1.3. Beschreibung der Orderkarte 


\Feldname od. | Oblige- | Maxim. 
Ia. 


ie 
It 
| 3 
| 
I 
re 


2. 


Die Orderkarte hat folgenden Aufbau: 


-TCONY, OD=od, I?=it, pk, VN=vn 


; Mégliche | Bedeutung des Bemerkungen 


Schliissel | toriach | Linge i Werte ' Feldea 
Hy = i. 7 moc 

OD=04 ja 1 0-7 Ausgabeplatte F 
Itsit ja 1 1-8 | Eingabetend | 
pk ja lj K oder L: Schreibdichte | i 

! K+1600 L=800 
i i 
| al ; alle Num. Volume-Seris | Mit SWITCH 1 

Werte ; Nummer i keine Kont- 

| 


i | rolle 


Zusatz programme 


Auf der Basisplatte muss die Order SPVYAUXM vorhanden sein. 


Ref, RS ET 025 
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«TCONV | 
3. Benutzungsgrundlagen 
3.1. Beschreibung der Detailkarten 


Ab Spale 1 werden die Dateinamen (max. 12 Stellen) der 
Dateien, die auf Platte auriickgeschrieben werden sollen 
abgelocht, fortlaufend ohne Zwischenraum nur getrennt 
durch Koma. 


fn,fn,fn,e-. 
Reicht eine Detailkarte nicht aus, kann eine zeite oder 


dritte Karte angelegt werden, Es sind maximal 20 Datei- 
namen méglich. 


Als letzte Karte muss eine BEND - Karte folgen. 
3626 Eingabe tiber Kartenleser 


ORDERKARTE 
END 


Es werden alle Dateien die auf Band gesichert wurden, auf 
Platte zuriickgeschrieben, 


ORDERKARTE 
DETAILKARTE(N) 
END 


Es werden nur die Dateien, die in der Detailkarte angegeben 
sind vom gesicherten Band auf Flatte zuriickgeschrieben. 


3.36 Ausgabe 


Druckprotokol1 
Wenn eine Datei iibertragen ist, wird der Dateiname mit Bele- 
gung Datei und die Meldung "UZBERTRAG BEENDET" ausgedruckt. 


344. Punktionslogik 


Die Datei, mehrere oder alle Dateien, die von Band auf die 
Platte zuriickgeschrieben werden sollen, werden auf die fiir 
die Datei reservierten Zylinder zuriickgeschrieben inklusive 
Overflowzone und Indexzylinder, falls vorhanden. Der HDR 
wird wieder auf den Stand der gesicherten Datei gebracht. 


Auf die Datei, die von Band auf Platte zurtickgeschrieben 
wurde, muss kein Indexing gefahren werden. 


Die Datei oder Dateien die auf dem Band gesichert sind, kén- 
nen auch auf eine leere Platte szuriickgeschrieben werden, 
jedoch miissen voher die Dateien mit der Zylinderbelegung 
der Originalplatte durch die Order .SFD auf der leeren 
Platte definiert werden, 


Ref. RS ET 025 


4.1. 


4.2, 


4ode 


“2 9 - 


-TCONV 


Fehlermeldungen 


Ausdruck auf Drucker 
“HDR ANZAHL OVERFLOW " 


In dre Detailkarte sind mehr als 20 Dateinamen angegeben 
worden. 


" HDRI..+- «+eNICHT GEFUNDEN " 


Der in der Detailkarte angegebene Dateinamen wurde euf dem 
Band nicht gefunden. 


" DATBIPLATZIERUNG AUF DATEI FALSCH " 


Die Datei, die vom Band auf Platte zurtickgeschrieben werden 
soll, hat anf der Platte den gleichen Namen, jedoch stimmen 
die auf der Platte definierten Zylinder nicht mit der Origi- 
naldatei tiberein, 


" ORDERCARD WRONG " 
Fehlerhafte Orderkarte. 


“ DISCPACK BEINHALTET KEINE DATEI " 
Auf der Platte fehlen die oder der Dateikennsatz. 


“ TAPEMARK WRONG " 
Tapemark des Bandkennsatzes ist falsch. 


Nicht blockierende Haltefaélle mit Ausdruck 
Hit. 1111 mit Ausdruck " VN= ANGABE FEHLT " 


VN= Angabe fehlt in der Orderkarte. Wenn keine Priifung der 
Volume -- Serie Nummer verlangt wird, kann mit SWITCH 1 das 
Programm weitergefiihrt werden. . 

Hlt. 1122 mit Ausdruck " FALSCHE VOLs NR. " 


VN= Angabe stimmt nicht mit der Ausgabeplatte iiberein, 
Das Programm kann mit SWITCH 1 weitergefiihrt werden, 


Blockierender Haltefall ofne Ausdruck 
Hit. OFFF 
Undefinierbarer Fehler von Bandstation. 


Ref. BT 025 


ell. 


«DELOT 


»DT157 KONVERTIERUNG DISC = TAPE 


Lis Allgemeines 


Die Daten einer DSY 157 werden vollstandig auf ein 
Sicherungsband tibernommen. 


Handelt es sich um eine SD, LD oder MD, so kann durch 

Binschalten des SWITCH 2 eine Liste in Form der Order 

LIST der gesicherten Programmdatei ausgedruckt werden. 
1.1, Anruf 

Das Programm wird durch die Order .DT157 angerufen. 


1.2, Hardwarevoraussetzungen 


- zwei Plattenstationen DSU 157 
- eine Bandstation 9 Spur 

- Kartenleser oder CTW 

~- Drucker 


1.3. Beschreibung der Orderkarte 
Die Orderkarte hat folgenden Aufbau: 


.DT157 Spalten 7 - 80 bleiben leer. 


2. Zusatzprogramme 
Auf der Basisdise miissen die Order SPVAUXM und .LIST 
vorhanden sein. 

Be Benutzungsgrundlagen 


3,1. Anwendungsnormen 
Das Programm konvertiert die Plattenstation Nz. 1 auf 
die Bandstation Nr. 8. 

Bee Pynktionslogik 
Die DSU 157 wird, beginnend bei Sektor 00000 bis Sektor 
39999, in Form von 14 400-stelligen Saétzen auf das Band 
auf Station Nr. 8 konvertiert. 
Nach Ablauf wird die Station auf 'UNLOAD' gebracht und 
die Plettenstetion auf Zylinder 0 zurtickpositioniert. 
Deg Band “kewm einen dettebiger Kennsatz aufweisen. Bee 
Programe —sehreiby—eiren-eteenen,. 


Ref. RS ET 025 


eDT157 


4. 
ast 


2222 
2253 
3333 
3344 
6666 
6677 

5. 

5.1. 

5.2. 


-12- 


Fehlermeldungen 


Haltefalle 


Beschreibung 


Ende des Bandes auf MTH 8 


Plattenstation 1 ausser 
Betrieb 


Massnahme des Operators 
Grésseres Band einspannen 
Programm neu laden 


Entstéren 
Programm neu laden 


Bandstation 8 ausser Entatoren 
Betrieb t Programm neu laden 
Plattenstation 1 Station ausschalten, wieder 
Postionierfehler einschalten 
Programm neu laden 
Blocknummer - Fehler / Prograum neu laden 
Plattenstation 1 Station ausschelten, wieder 
Lese - Schreibfehler ' einschalten 
| Programm neu laden 
Bandstation 8 Programm neu laden 
Lese - Schreidfehler 
Plattenstation 1 Programm neu laden 
Undefinierter Fehler 
Bandstation B Programm neu laden 
Undefinierter Fehler 
Bemerkungen 
Zeitbedarf 
Normale Konvertierung < 4 Minuten 20 Sekunden 


Konvertiervng nit .LIST (sw z) 5 


Kernspeicherbelegung 
14 762 Bytes, davon 14 400 fiir Input - Outputzone,. 


60 KHa Bin 
Minuten 05 Sekunden } one 


Ref, RS BY 025 
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#TDL57 


«TD157 KONVENZIERUNG TAPE ~ DISC 


Le Allgemeines 


Die Daten eines mit der Order .DT157 erstellten Sicherungs= 
bandes werden vollsténdig auf eine DSU 157 = Platte zuriick= 
geschrieben,. 


Eandelt es sich um eine SD, LD oder MD, so kann durch das 
Einschalten des SWITCH 2 eine Liste in Form der Order 
LIST der erstellten Platte ausgedruckt werden. 

1.1. Anruf 
Das Programm wird durch die Order .TD157 angerufen. 


1.2. Hardwarevoraussetzungen 
- agwei Plattenstationen DSU 157 
- eine Bandstation 9 Spur 
~ Kartenleser oder CTW 
- Drucker 


1.3. Beschreibung der Orderkarte 
Die Orderkarte hat folgenden Aufbau: 


oTDL57 Spalten 7 - 80 bleiben leer. 


26 Zusatzprogramme 
Auf der Basisdise miissen die Order SPVAUXM und ,LIST vors 
handen sein, 


Dei Benutzungsgrundlagen 


Bele Anwendungsnormen 


Das Programm konvertiert die Bandstation 8 auf die 
Plattenstation 1. 


sesvhSrcben—TeEcen. . 1 ' * 
Wenn, cies Bond act ene neue Ploite geschrieben wirdl muss awerst 


ein « DUW gemacht Wenlon (semeint ist ene bis anhin uubenctete Plette) 


Das Magnetband wird auf die DSU 157 beginnend bei Sektor 
00000 bis Sektor 39999 konvertiert. 


Nach Ablauf des Programms wird die Magnetbandstation Nr. 8 
auf ‘UNLOAD' gebracht und die Plattenstation Nr, 1 auf 
Zylinder O zuriickpositioniert. 


Ref. RS ET 025 


ena cee 


-TD157 
4. Fehlermeldungen 
4.1. Haltefille 
Halteadresse y Beschreibung | Massnahme des Operators 
1111 Plattenstation 1 ausser Entstéren 
Betrieb Programm neu laden 
1122 Bandstation 8 ausser Entstoren 
| Betrieb Programm neu laden 
2222 Plattenstation 1 Station ausschalten, 
i Positionierfehler wieder einschalten 
{ Programm nev laden 
2233 fi Blocknummer - Fehler Programm neu laden 
3333 Plattenstation 1 Station ausschalten, 
Lese - Schreibfehler wieder einschalten 
Programm neu laden 
3BA4 Bandstation 8 Station ausschalten, 
Lese - Schreibfehler Rewind und wieder 
einschalten 
Programm neu laden f 
6666 Plattenstation 1 Programm neu laden | 
Undefinierter Fehler 
TTT Bandstation 8 Programm nev laden ' 
Undefinierter Fehler 
5e Bemerkungen 
5.1, Zeitbedarf 
Normale Konvertierung 5 Minuten 10 Sekunden 
Konvertierung mit .LIST (SW 2) 6 Minuten 00 Sekunden 
5.2. Kernspeicherbelegung 


14 736 Bytes, davon 14 400 fir Input - Outputzone,. 


Ref. RS ET 025 
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-«DDP157 KONVERTIERUNG PLATTE = PLATTE 


1 Allgemeines 


Dieses Programm konvertiert eine Platte auf eine andere. 
Dabei wird die Platte vollstindig d. h. mit den gelésch= 
ten Records gesichert. 


Das Programm .DDP157 sollte anstelle DISKDISK benutzt 
werden, da das DISKDISK teilweise (bei IDS) nicht 
korrekt arbeitet und vom Handling her sehr aufwendig 
ist. 

1.1. Anruf 
Das Programm wird mit der, Order .DDP157 angerufen. 


1.2. Hardwarevoraussetzungen 
- drei Plattenstationen DSU 157 
- Kartenleser oder CTW 


- Drucker oder CTW 


La3e Beschreibung der Orderkarte 
«DDP157 Spalten 7 - 80 bleiben leer, 
2. Zusatzprogramme 


Auf der Basisdisc muss die Order SPVAUXM vorhanden sein. 


3. Benutzungsgrundlagen 


Das Programm iibertragt den Inhalt einer ganzen Platte 
von der Plattenstation 2 auf die Plattenstation 1. 


Ref, RS BT 025 
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»DDP157 
4. Fehlermeldungen 
4.1. Haltefalle 
Halteadresse: Beschreibung Massnahwe des Operators 
— += 
1000 Plattenstation 2 Programm neu laden 
Undefinierter Fehler 
111 Plattenstation 2 FILE ALERT léschen 
PILE ALERT Programm neu laden 
2222 Plattenstation 2 Station ausschalten, 
Positionierfehler wieder einschalten 
: Programm new laden 
3333 Plattenstation 2 Programm neu laden 
Lese - Schreibfehler 
2000 Plattenstation 1 Progremm nev. laden 
Undefinierter Fehler 
1122 Plattenstation 1 FILE ALERT léachen 
PILE ALERT Programm neu laden 
2233 Plattenstation 1 Station ausschalten, 
Positionierfehler wieder einschalten 
Programm neu laden 
3344 Plattenstation 1 Programm neu laden 


L Lese - Schreibfehler 


——| 


Ref, RS ET 025 
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YDTGGE 
°o UP ERRECHNEN ANZAHL TAGE ZWISCHEN ZWEI DATEN 
Aufgabe: Das UP errechnet die Anzahl Tage, die 


zwischen zwei gegebenen Daten liegen, 
mit Berticksichtigung von Schaltjahren. 


Benutzte Kapazitits: 216 Bytes 


Eingabe: Das Ausgangs- und Enddatum in der Form 
Tag, Monet, Jahr (TTMMJJ), 


Ausgabe: Anzahl der zwischen den beideb Daten 
liegenden Tage. 


Bemerkungen: Das UP ist im Operatingsystem EDOS ab 
Version 25 enthalten. 


9° 


Anruf: Bas UP wird APS - maissig wie folgt 
angerufen: 
‘ *DIGGE DATUM1,DATUM2, TAGE+4 


DATUM] und DATUM2 sind die Eingabe- 
werte, TAGE ist des Feld, das nach den 
Durchlauf des UP das Ergebnis enthélt. 


Die beiden ersten Operanden (DATUM1 und 

DATUM2 )enthalten die linke Adresse der 

Eingabewerte, wihrend der dritte Operand 

(TAGE) die rechte Adresse eines mindestens 

fiinfatelligen Feldes enthalten muss, 
Anmerkungen: - Das UP beriicksichtigt die Schaltjahre. 

- Die Ausgangsdaten bleiben erhalten. 

« Es gibt keine Fehleranzeige. 


(@) - Die Reihenfolge der beiden Eingabewerte 
ist beliebig. 


Ref. RS ET 025 
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9 YGGDTE 


UP UMRECHNUNG DATUM + TAGE IN DATUM 


Aufgabe: 


Das UP errechnet ein Félligkeitadatum 
aus einem gegebenen Datum und einer 
Anzahl Tage (maximal 9999). 


Benutzte Kapazitat: 364 Bytes 


Eingabes 


Ausgabe: 


Bemerkungens 


Anruf: 


Anmerkungens 


Ausgangsdatum in der Form Tag, Monat, 
Jahr (TTMMJJ) und die zu addierende 
Anzahl Tage. 


Das Féilligkeitsdatum in der Form Tag, 
Monat, Jehr (TTMMJJ). 


Das UP ist im Operatingsystem EDOS ab 
Version 25 enthalten. 


Das UP wird APS - missig wie folgt 
angerufen: 


*GGDTE DATUM,TAGE 


Im Feld DATUM muss das Ausgangsdatum 
in der Form TTMMJJ und im Feld TAGE 
die Anzahl Tage zur Verfiigung gestellt 
werden, 


Die Tageszahl kann maximal vierstellig 
sein (max. 9999). 


Die Bezeichnung der Felder DATUM/TAGE 
kann andere gewihit werden, die Reihen- 
folge ist jedoch obligatorisch. 


Das errechnete Faélligkeitsdatum steht in 

der Kernspeicherzone des Feldes DATUM 

nach Durchlauf des UP zur Verfiigung. Es 

hat die gleiche Form wie die Bingabe (PTMMIT). 


- Die Ausgangsdaten im Feld DATUM werden 
im Verlauf des UP serstért. 


- Das UP beriicksichtigt die Schaltjahre. 


- Es gibt keine Fehleranzeige. 


Ref. RS ET 
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YEBCDY 
UP ZUR UMSCHLUESSELUNG EBCDIC = IN G100 INTERN CODE 
Aufgabe: Das UP schliisselt ein Feld, das Zeichen 


im EBCDIC Code enthilt, vermittelst einer 
Unschliisselungstabelle in den G 100 intern 


Code um. 
Eingabe: Ein Feld im EBCDIC Code. 
Ausgabe: Ein Feld im G 100 intern Code (dasselbe wie Eingabe). 
Bemerkungen: Das UP ist im Operatingsystem EDOS ab 
Version 25 enthalten. 
Anruf: Das UP wird APS-mdssig wie folgt eangerufen: 


*EBCDY FELD1,nnnn 
FELD1 ist die Adresse des umzuschliisselnden 
Feldes, nnnn bedeutet die Linge dieses 
Feldes ohne jegliche Abziige. 
Nach Durchlauf des UP enthaélt FELD1 die 
umgeschiisselten Zeichen im G 100 intern 
Code. 


Ref, RS ET 025 
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YGECDY 
UP ZUR UMSCHLUESSELUNG G 100 INTERN - IN EBCDIC CODE 
Aufgabe: Dae UP schliisselt ein Feld, das Zeichen 


im G 100 intern Code enthilt, vermittelst 
einer Umschltisselungstabelle in den EBCDIC 


Code um. 
Eingabes Ein Feld im G 100 intern Code. 
Ausgabe: Ein Feld im EBCDIC Code (dasselbe wie Eingabe). 
Bemerkungen: Das UP ist im Operatingsystem EDOS ab 


Version 25 enthalten, 


Anruf: Das UP wird APS-missig wie folgt angerufen: 
*GECDY FELD1,nnnn 


FELD1 ist die Adresse des umzuschliisselnden 
Feldes, nnnn bedeutet die Linge dieses 
Feldes ohne jegliche:Abztige, 


Nach Durchlauf des UP enthélt FELD1 die 
umgeschliisselten Zeichen im EBCDIC Code, 


Anmerkungen: Es ist zu beachten, dass eine negative Null 
(40 hexadezimal) in eine nicht numerische 
5B - anstelle DO hexadezimal umgeschltisselt 
wird. 


Aus diesem Grunde sollte vor Ablauf des UP 
das umzuschliisseinde Feld auf negative Nulien 
untersucht werden und gegebenenfalls auf 

CO hexadezimal abgedndert werden. Dann wird 
der wert richtig umgeschlisselt. 


Ref, RS ET 025 
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UP ZUR UMSCHLUESSELUNG H 200/2000 - IN G 100 INTERN CODE 


Aufgabe: Das UP schliisselt ein Feld, das Zeichen 
in £ 200/2000 intern Code enth#lt, ver- 
mittelst einer Umechlisselungstabelle in 
den G 100 intern Code un, 


Eingabes Ein Feld im H 200/2000 intern Code. 
Ausgabe: Ein Feld im G 100 intern Code (dasselbe wie Eingabe). 
Bomerkungen: Das UP ist im Operatingsystem EDOS ab 


Version 25 enthalten. 


Anruf: . Das UP wird APS-massig wie folgt angerufen: 
*HONEY FELD1,nnnn 


FELD1 ist die Adresse des umzuschliisseinden 
Feldes, nnnn bedeutet die Lange dieses 
Feldes ohne jeglichen Abzug. 


Nach Durchlauf des UP enthaélt FELD1 die 
ungeschliisselten Zeichen im G 100 intern 
Code. 


Ref. RS ET 025 
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YGRHOY 


UP ZUR UMSCHLUESSELUNG G 100 = IN H 200/2000 INTERN CODE 


Aufgabe: Das UP schlisselt ein Feld, das Zeichen 
im G 100 intern Code enthélt, vermittelst 
einer Umschlisselungstabelle in den 
H 200/2000 intern Code um, 


Bingabe: Ein Feld im G 100 intern Code. 
Ausgabe: Bin Feld im H 200/2000 intern Code 


(dasselbe wie Bingabe), 


Bemerkungen: Dae UP ist im Operatingsystem EDOS ab 
Version 25 enthalten. 


Anrufr Das UP wird APS-missig wie folgt angerufen: 
*GEHOY  FELD1,nnnn 


FELDL iat die Adresse des umzuschliisselnden 
Feldes, nnnn bedeutet die Linge dieses 
Feldes ohne jeglichen Abzug. 


Nach Durchleuf des UP enthélt FRLD1 die 
umgeschltisselten Zeichen im H 200/2000 
intern Code. 


Ref, RS ET 025 
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Betriebssystem 


4. Auflage, August 1973 


Honeywell Bull 


Ref.-Nr.: 32.98.010 D 2 


Datum - Erstausgabe Seiten - Erstausgabe Gesamtanzaht 
Datum - Updating Seiten - Updating Seiten 


EDOS (und DOS II) Programmier-Handbuch Tei! 1 
Juni 1971 | Deckblatt, Inhaltsverzeichnis | bis XV 
Text 1 bis 564 


Deckblatt, Inhaltsverzeichnis | bis XVIII. 
Text:3 -5, 7,9-11, 16-17, 26 - 27, 39, 41 - 42, 45 - 48, 69, 74, 
76, 80, 84 - 88, 91, 93-95, 99 - 116.4, 117 - 118, 120, 130, 134, 
139, 143, 149, 158 ~ 166.26, 182 - 185, 194.1 - 194,20, 199, 201, 
203 - 204, 209 - 214.2, 215, 216.1 - 216.8, 217 - 219, 220. 1 ~200: g 
223 - 224, 229 - 235, 237, 243 - 249, 251, 257, 259 - 262, 265 - 266, 
1 268 - 272, 274, 281, 283 - 288, 298, 301, 312, 327 - 328, 330 - 331, 
333, 336, 355 - 363, 365 - 366, 371, 377 - 381 , 384 - 385, 390, 393, 
Juni 1972 | 395 - 396, 399, 401, 403 - 405, 407 - 411, 413 - 417, 425, 431, 433, 


438 - 439, 441, 449, 454 - 458, 462 ~ 463, 466.1 - 468.2, 473 ~ 480, 
483, 485 - 486, 489 ~ 496, 499, 500.1 - 500.4, 503, 506 - 516, 
521 - 526, 538 - 540, 551 - 552, 557, 560 - 562. 


3, 19, 25, 39, 41, 42, 105, 106, 109, 147, 156, 166.1, 166.4, 
185, 194.20, 210, 212, 220.2, 220.5, 220.9 - 220.12, 224, 
260.1 - 260.2, 283, 290, 307, 324.1 - 324.24, 327, 328, 
November} 328.1 - 328.2, 356, 357, 358, 361, 378, 379, 387, 387, 399, 
72 405, 437, 462, 467, 468, 468.2, 475, 525, 526, 532.1, 532.2, 
532.3, 532.4, 549, 550, 562.1 - 562.4, 430 
Deckblétter, Titelblatt, Inhaltsverzeichnis IX, X, XI, XV 


324,24, 324.25 - 324.30, 400, 478, 480 


3 214, 282, 324.1, 324.4, 324.5, 324.9- 324.14, 324.16, 324.22, 
Deckblatter, Titelblatt, Inhaltsverzeichnis XI 


Juli_1973 


Wir empfehlen Ihnen, zu Kontrollzwecken dieses Blatt nach der Titelseite 
in Ihr Handbuch einzufugen. 


Durch diese Ausgabe werden folgende BroschUren ungUltigs 
EDOS Programmierhandbuch Ref.~Nr.: 32.38.010 von Juni 1971. 
EDOS (und DOS !!) Programmierhandbuch Teil 2, Ref.-Nr.: 32.38. 011 vom Mai 1971. 


November 1972: Dieses Updating mu8 in das EDOS-Handbuch, Ref.-Nr.: 32.38.010 
vom Juni 1972 eingeordnet werden. 
Juli 1973: Dieses Updating mu8 in das EDOS-Handbuch, Ref.-Nr.: 32.38.010 


vom Juni 1972 eingeordnet werden. 


G-118/120/130 ee eet 
Ref .-Nr.s 32.38.010 D3 
Juni 1972 / Rev. Juli 1973 


Order fur Sei 
EDOS| DOSH| 7ite 


Bezeichnung 


Dateikennsitze drucken 
Kompilierung Fortran~Programm 
Dateitabelle fortschreiben 


Generierung und Updaten einer 


Source -Programmdatei 303 
-GAFCONY Konvertieren Sourceband 324. 
«GAFUPD Warten Source-Datei 324. 
»GAFUSIC Sichern einer Sourcée-Datel auf Band 324 . 2: 
«GPP Ausstanzen Source=Programm 216.1 
«GPPCK Vergleichsorder fur .GPP 216.1 

325 

Kompilierung eines IDS-Programms 327 

Systeminitialisierung 329 


Drucken Programm- und UP-Liste 
Programm laden und Start (Hauptprogr .) 
Laden eines CONCURRENT -Programms 
Ausstanzen eingesetztes Programm 
Vergleichsorder fUr .LPP 

Ausstanzen eingesetzte Unterroutine 
Vergleichsorder fur .LSP 
G-118/120/130 Ee 
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xx KKK KK 


- XIb- 


Ordername Haupt~ | Sub- 
order __|.order 


Bezeichnung 


Order fur 
EDOS} DOSII 


M 


«MDG 


Generierung Master Disc 


«MDP Kernspeicherausdruck 
-MDS x Master Disc Stop 
+MONITOR Master Disc Start 


N 


ZurUckschreiben einer Datei cuf Platte 
ZurUckschreiben einer Programmdatei 
auf Platte 


- NS99DF 
«NS99PF 


Unterbrechung der Bearbeitung 


G~118/120/130 


Ref. -Nr.: 32.38.0130 D 1. 
Juni 1971/Rev. Februar 1972 


*OS *51031 * 


* OS *51032 * 


*OS *51033 * 


*OS *51036 * 


*OS *51046 * 


*OS *51108 * 


*OS *51127 * 


* OS *51133 * 


*OS *51144 * 


*OS *51225 * 


*OS *51226 * 


G-118/120/130 


-213 - 


ID/OD = N PFL NOT FOUND 


Auf der Plattenstation mit der logischen Nummer N konnte 
kein Programmkennsatz gefunden werden. 


ID/OD = MD/SD/LD NOT FOUND 


Der Code MD, SD oder LD, angegeben in der Orderkarte, 
konnte im Programmkennsatz nicht gefunden werden. 


1D/OD = N= MD/SD/LD NOT ACCEPTED 


Ein falscher Code MD, SD oder LD im Programmkennsatz 
auf der Plattenstation mit der logischen Nummer N. 


ID/OD = WD UNDEFINED 


Die Arbeitsplatte wurde nicht definiert. 


SUBROUTINE XXXXXX WRONG 


in der Unterroutine XXXXXX wurden bei der Umwandlung 
nicht -standardméBige Eigenschaften vorgefunden. 


INVALID ’STRT’ CARD 
Die erste Karte des Source-Programms ist keine STRT-Karte. 


SUBROUTINE INDEX WRONG FOR XXXXXX 


Die Subroutine XXXXXX hat eine nicht-standardmaBige 
Lange im Kennsatz. 


DU = NWORK SPACE OVERFLOW 


Auf der Plattenstation mit der logischen Nummer N reicht 
die Arbeitszone fur die Assemblierung nicht aus, oder sie 
felt. 


NL = XX NOT ACCEPTED 
Der Parameter NL wurde fehlerhaft abgelocht. 


DV = XXX NOT ACCEPTED 


In der Orderkarte lautet der Parameter flr den Anruf 
der DSU157 "XXX" statt "157". 


PG = X NOT ACCEPTED 


In der Orderkarte lautet der Parameter fUr den Anruf der 
Umwandlung eines CONCURRENT PROGRAM "X" statt "C". 


Ref. -Nr.: 32.38.010 DI 
Juni 1971/Rev. Febr. 1972 


oO 


* OS *51300 * 


*OS *51301 * 


*OS *51302 * 


* OS *51303 * 


* OS *51304 * 


* OS *51306 * 


-214 - 


DU = N OBJECT PROGRAM OVERLAYS SOURCE 


In den Parametern ID und OD wurde die gleiche 
Stationsnummer angegeben. Dies ist nicht méglich, 
wenn das Source-Programm auf der Platte steht, da 
der Programmname dann doppelt vorhanden wire. 


DU = N TRANSLATION IMPOSSIBLE WITHOUT WORK DISC 


Die Assemblierung auf der Plattenstation mit der logischen 
Nummer N erfordert eine Arbeitsplatte. 


INVALID .APS TRANSLATION FOR ERRORS NO. XXXX 


Die Assemblierung wurde vollsttindig durchgefhrt, aber 
das Programm enthdlt XXXX Fehler. 


INVALID . SRC TRANSLATION FOR ERRORS NO. XXXX 


Die Assemblierung wurde durchgefthri, aber das Unter- 
programm enthalt XXXX Fehler. 


INVALID .DSRC TRANSLATION FOR ERRORS NO. XXXX 


Die Assemblierung wurde vollstaindig durchgefihrt, aber 
das Unterprogramm fur die Plattenbearbeitung enthalt 
XXXxX Fehler. 


INVALID .DAPS TRANSLATION FOR ERRORS NO. XXXX 


Es wurde eine Assemblierung fur ein System Uber 32 K durch- 
gefUhrt; die Umwandlung enthilt jedoch XXXX Fehler, 


Nach allen oben angegebenen Meldungen endet das Programm mit dem 


Makrobefehl ABORT. 


* OS *51999 * 


*OS *51999 * 


*OS *51999 * 


G-118/120/130 


END OF .APS 

Die Assemblierung des Programms wurde erfolgreich 
durchgefuhrt. 

END OF .SRC 

Die Assemblierung des Unterprogramms wurde erfolgreich 
durchgefthrt. 

END OF .DSRC 


Die Assemblierung eines Unterprogramms fur Platten- 
bearbeitung wurde erfolgreich durchgefuhrt. 


ES 
Ref. -Nr.: 32.38.010 D3 
Juni 1971/ Rev. Juli 1973 
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Oo we 


-ED99DF SAVE A DATA FILE ON TAPE 


Sichern einer Datendatei auf Band 
(Diese Order ist im DOS ft nicht zulassig.) 


1 Allgemeines 

Dieses Programm wird zur Sicherung einer Datendatei auf Band benutzt. 
11, Anruf 

Das Programm wird mit der Order .ED99DF angerufen. 
1.2. Hardwarev oraussetzungen 


i) - Kartenleser oder CTW 101 
- Drucker 
~ Platteneinheit 


- Magnetband 
1.3. Beschreibung der Orderkarte 
Die Orderkarte hat folgenden Aufbau: 


«ED99DF, fn, joa | , ot, ck, pk 
Es bedeutet: 


fn Name der Dotei (HDR -Kennsatz) 
ot Nummer des Ausgobebandes (1-7). 
oO ck Pfr Unpoarigkeit 
O fbr Poarigkeit 
pk Schreibdichte fur das Ausgabeband: 
K fur 1600 bpi 
L fur 800 bpi 


ID=id Wahlfrei; enthélt die logische Nummer der Eingabeplatte 
{Werte 0-7, BD, WD), wenn er fehlt, wird ID=BD angeommen. 


1.4. Einschrénkungen 
- Dieses Programm sichert nur Datendateten. 


~ Des Ausgabeband muf ein 9-Spur-Band sein. 


G -118/120/130 a ed 
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- ED99DF 


2. Zusatzprogramme 

Die Basisplatte mu8 die Order .SPVAUXM enthalten. 
3. Anwendungsnormen 
3.1. Funktionslogik 


Nach der Formatkontrolle des Eingabeparameters und der Platten- und 
Bandkennséitze wird die Datei Spur fiir Spur auf Band gesichert. 


Die Blocklénge betrégt: 


- 3.845 Zeichen im 6-Bit-Modus 
~ 2,885 Zeichen im 8~Bit -Modus 


Nach der Sicherung der letzten Spur auf Band wird das Ausgabeband 
mit Standard EOF abgeschlossen, zuriickgespult und auf UNLOAD gesetzt-. 


Anmerkungs 


Bei sequentiell-indizierten Dateien wird der Indexzylinder nicht mit 
auf Band tbernommen. Nach der Riicktibertragung auf Platte mu der 
Indexzylinder neu erstellt werden. 


G -118/120/130 St 
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-GAFCONV = GENERAL FILE CONVERSION 


Konvertieren von Source~Dateien von Magnetband auf Magnetplatte 


Ve Spezifikationen 


Das Programm konvertiert ein Sourceband auf eine Plattendatet. 

Des Sourceband kann ein APS~, COBOL- oder FORTRAN ~Sourcéband 
sein, es muB dem Aufbau der GAF-Bander entsprechen. 

(4005 Bytes Blocklange, WA = 80 Stellen.) 


Ferner kénnen MIACS-Sourcebénder konvertiert werden, die den 
oO GAF -Bandern dhnlich sind. 


Die Plattendatei mu® sequentiell im 8-Bit Modus angelegt sein, 
Plattenwechsel ist nicht méglich. 


Die Plattendatei ist zum COBOL- und FORTRAN-Compiler nicht 
kompatibel. Werden Programme zur Kompilierung bendtigt, missen 
sie vorher durch die Order .GAFUPD bereitgestellt werden. 


AvBer den vollstandigen Sourcebindern kénnen daraus auch einzelne 
Programme Ubernommen werden. 


11. Anruf 
oO Das Programm wird durch die Order . GAFCONV angerufen. 
1.2. Hardwarevoraussetzungen 


- Kartenleser oder Schreibmaschine CTW 101 
- Drucker 


- zwei Magnetplatten 


- Magnetbandstation. 


° 


Ref. -Nr.: 32.38.010 D3 
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-GAFCONV 


1.3. 


+324.2 - 


Beschreibung der Orderkarte 


« GAFCONV, IT=it, ck, pe [OD=od [i=t] [F=f] [rev [mr] 


Bedeutung der Parameter in der Orderkarte: 


Feldname Obligato- | Max. | Migliche 
od. Ifd. risch Linge | Werte 
Schlussel 

IT ia 1 

ck ia 1 Pp 

pk ia 1 K,L,M,N 
OD nein 1 Paz. 

LT nein 1 A,C,F 
FN nein 12 beliebig 
CR nein 1 Y,N 

Mi nein 1 Y,N 


moet] 


Bedeutung des 
Feldes 


Nummer der 
Bandstation 


Unpaarig- 
keit 


Schretbdichte 


Log. Nummer 
der Platte 
Language -Typ 
des Source - 
bandes . A wird 
angenommen. 


Dateibe- 
zeichnung 


Detailkarten 
Uber den 
Karienleser 


MIACS- 


Sourceband 


UNLOAD gesetzt. 


M,N nur bei 
7-Spur-Stationen 


1 wird ange- 
nommen 

A= APS 

C= COBOL 

F = FORTRAN 


SOURCE wird 


angenommen 


nur bei Uber- 
nahme einzelner 
Programme anzu- 
geben 


nur bei MIACS- 
Buindern an- 
geben. 


Bemerkungen 
Nach dem Rick - 
spulen wird die 
Station auf 
| 
i 
i 
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1.3.1.  Detailkarte 
Aufbau der Detailkarte: 
Spalte 1, 11, 21, 33, 41, 53, 61, 71: 
Ab der ersten genannten Spalte kann eine Programmbezeichnung 
angegeben werden, die Programmbezeichnungen kénnen in weiteren 
Detailkarten fortgesetzt werden. 
Beginnt in einer der ersten Spalten die BEND-Information, 
wird die Bearbeitung beendet. 
1.4, Den Meldungen wird die Nummer 77 vorangestel lt. 
2. Zusatzprogramme 
Das Programm benutzt die Zusatzroutinen *STAND, *OSDS, * OSTP. 
3. Benutzungsgrundlagen 
Nach dem Laden des Programms erfolgt die Format-Kontrolle der 
Orderkarte . 
Wenn der Parameter CR=Y angegeben ist, wird eine Detailkarte gelesen 
und das erste dort angegebene Programm auf dem Band gesucht. Nach dem 
Auffinden wird das Programm auf die SOURCE -Dise Ubertragen und das 
nachste Programm gesucht usw. 
Wenn eine KEND-information gefunden wird, wird die Ubertragung 
beendet. 
In der Detailkarte mUssen die Informationen in aufsteigender Reihen- 
folge angegeben werden. 
Das Sourceband kann mit der Order . GAF oder einem anderen Programm 
erstellt worden sein. (Blockléinge 4005 Zeichen, Satzlénge 80 Stellen.) 
Auf einem Band kénnen COBOL- und APS-Programme in gemischter Form 
vorliegen. Das Band wird mit LT=A konvertiert. 
Bei FORTRAN -Source-Béindern wird LT=F angegeben. 
MIACS-Biinder enthalten im Normatfal! COBOL~- und SPG -Programme. 
Beide Arten werden auf die SOURCE -Dise Ubernommen und kénnen von dort 
durch die Order . GAFUPD zur Umwandlung bereitgestellt werden. 
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Die Sourcedatei enthalt einen Indexzylinder im ersten Zylinder der 
reservierten Zone und anschlieflend die Source-Programme. 


Die Sourcedatei kann durch die Order . GAFUPD weiter bearbeitet 
werden. 


4. Meldungen und Fehlermeldungen 


CARD-ERROR 


In der Detailkarte sind Fehler enthaften. Detailkarte prufen und 
Programm nev starten. 


PROGRAM NNNNNNNN NOT FOUND 


Das in der Detailkarte angegebene Programm wurde auf dem Source~ 
Band nicht gefunden. Di2 Bearbeitung wird mit dem niéchsten in der 
Detail-Karte angegebenen Programmnamen fortgesetzt. 


* OS *77005 * DU=x: CL=>XXX OVERFLOW 


Auf der angegebenen Plattenstation reicht die Datei zur Aufnahme 
der Sourcedatei nicht aus. 


START OF CONVERSION TAPE TO DISC 


Diese Meidung wird zu Programmbeginn ausgedruckt. 


APS/COBOL SOURCE-PROGRAMS 


Es wird angegeben, welcher Dateityp konvertiert wird. 


FORTRAN-SOURCE -PROGRAMS 
Es wird ein FORTRAN -Sourceband konvertiert. 


PROGRAM NNNNNN MULTIPLE ON SOURCE-FILE, NOT INSERTED 


Das angegebene Programm ist bereits auf der SOURCE-Platte enthalten 
und wird auf dem SOURCE -Band Uberlesen. 
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Das Programm .GAFCONV kann eine Indexliste mit allen auf einem 
Band enthaltenen Programmnamen erstellen. 


Dabei werden eine Kopfzeile cusgedruckt, deren Angaben folgende 
Bedeutung haben: (Beispie! niichste Seite). 


PROGRAM-CODE In dieser Spalte werden die Namen oder 
Nummern der Programme angegeben. 


SECTOR Es wird angegeben, ab welchem Sektor 
das Programm gespeichert ist. 
START -CARD -INFORMATION Diese Spalte enthalt: 
- Nummer der ersten Karte 
fe) ~ STRT-Befeh! 
 Startadresse und KernspeichergréBe 
END-CARD-INFORMATION = Angegeben werden: 


- Nummer der letzten Karte 
- END -Befeh! 
~ Symbolische Startadresse 


CARDS Angegeben wird die Anzah! der in einem 
Programm enthaltenen Karten. 


(Die Liste bezieht sich auf APS und SPG Programme, bei anderen 
Programmiersprachen werden nur BruchstUcke der END-Karte aus- 
gedruckt) 


Oo 
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-GAFUPD GENERAL FILE MANAGEMENT AND UPDATE PROGRAM 


Generieren, Warten und Updaten einer Sourcedatei 
auf Magnetplatte. 


1. Spezifikationen 


Dieses Programm ermiglicht die einfache Wartung simtlicher in einem 
RZ vorhandener Ursprungsprogramme (ausgenommen PGS). 
Sourceprogramme in APS, COBOL, SPG, IDS, FORTRAN und RPG 
werden von ihrem Ursprungskartensatz auf Magnetplatte geschrieben. 
Samtliche weiteren Operationen (Neuumwandlung, Anderungen etc.) 
werden auf der Basis dieser Sourcedatei durchgefuhrt. Eine bereits 
bestehende Sourcedatei auf Magnetband, zu einem friheren Zeitpunkt 

Oo durch die Order .GAF erstellt, kann durch die Order .GAFCONV 
auf die Platte konvertiert werden. 


1.1. Struktur der Magnet platte 


Die benutzte Magnetplatte sollte keine andere Datei enthalten. Die 

Datei wird im 8-Bit-Modus als Einfachdatei erstellt. Die Datei kann 

durch die Order SFD angelegt werden; sie kann auf Magnetband ge- 
sichert werden. Nach dem Wiederherstellen mUssen dieselben Zylinder wie 
vorher belegt werden (Rahdom-Zugriff). 


Der erste durch die Order reservierte Zylinder wird vom Programm 
«GAFUPD ais Indexzylinder betrachtet, die restlichen Zylinder werden 
in "Halbspuren" unterteilt. Bei jedem Schreibbefehl werden 
bei der Neutbernahme von Programmen 18 Karten & 80 Stellen ge- 
speichert . 

*) Eine Spur entspricht somit 36 Ursprungsprogrammkarten . 
Der Ubergang auf ein neues Programm erfolgt immer am Anfang 
einer neven “Halbspur". Beim Einflgen von neven Sdétzen mui 
nicht immer die gesamte Datei versetzt werden. Alle Zugriffe auf 
Programme oder einzelne Sétze erfolgen Uber den Index, welcher maximal 
1420 Programme aufnehmen kann. Die maximale Anzahl der auf der 
Platte speicherbaren Programme hingt von der GréGe der Datei und der 
GréBe der einzelnen Programme ab. 


Der Ubergang von einem Programm zu einem anderen ist durch den 
ProgrammschlUssel gekennzeichnet (Spalten 73 - 80 bei APS/COBOL- 
SPG- und IDS-Programmen; bei 75 - 80 bei RPG und 73 - 76 bei 
FORTRAN -Programmen) . 


la dieser Beschreibung wird die vom .GAFUPD gewartete Datei mit 
SOURCE bezeichnet. Diese Datei ist nicht kompatibel zu der von den 

(eo) Compitern benutzten Datei, die zur Unterscheidung mit SOURCE-PROGS 
bezeichnet wird. 
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1.1.1. Méglichkeiten der Bearbeitung 


°o 


Uberblick: 


- Ubernahme never Programme N-Karte 
- Updaten bestehender Programme 


« Léschen von Siitzen 


(1 Satz = 1 Karte) E-Karte 
. Ersetzen von Satzen S-Karte 
. Einsetzen von Sdtzen i-Karte 
- Drucken D-Karte 
- Stanzen / Prifen P-Karte / A-Karte 
oO ~ Léschen von Programmen C-Karte 
- Bereitstellen zum Umwandeln G-Karte 
~ Ausdrucken Programmindex B-Karte 
- Reorganisieren der Sourcedatei R-Karte 
~ Doppeln von Programmen mit nevem Namen V-Karte 
- Doppeln von Platte zu Platte M-Karte 
1.1.2. Erforderliche Hardware 


~ 16 K Kernspeicher 

~ Kartenleser oder CTW 101 

~ Drucker 

- zwei Magnetplattenstationen 
- Stanzer (wahlfrei) 


1.3. Beschreibung der Orderkerte 
-GAFUPD, OD=ed |, FN-fn] 


OD Parameter mit der fogischen Nummer der Plattenstation, 
auf der die SOURCE-Datei aufliegt. (Nummer 1 ~ 7 ) 


FN=SOURCE 


Wahlfreier Parameter mit dem Dateinamen. 
Es wird empfohlen, die Datei mit der Bezeichnung SOURCE 
anzulegen, da diese Bezeichnung automatisch angenommen wird. 


G-118/120/130 a ee enn 
Ref. -Nr.: 32.38.010D 3 
November 1972/ Rev. Juli 1973 


.°) 


+ 324.9 - 


1.3.1. Beschreibung der Detailkarten 
Alle Angaben in den Detailkarten erfolgen ab Spalte 1. 
N-Karte ~ NeuUbernahme von Programmen 
. N,PN=pn [-ur=it] [ 7Ry| 
PN=pn wahlfreier Parameter zur Angabe des Programmnamens. 
Wenn nicht angegeben, wird die in der ersten Source~ 
Karte enthaltene Bezeichnung Ubernommen. 
LT=It Gibt den Language-Typ an, d.h. die Pragrammiersprache, 
in der das Programm geschrieben ist. 
A wird angenommen. 
Méogliche Schlusse!: 
“A = APS 
c = COBOL 
| =IDS 
R = RPG 
F = FORTRAN 
S =SPG 
TR=Y Durch Anwendung dieses Parameters werden Karten im 
EBCDIC-Code in den normalen Hollerith-Code umgeschltisselt. 
Dadurch kénnen auch Programme fremder Hersteller Uber- 
nommen werden, TR=N wird angenommen. 
IDS-Programme sind zwar in COBOL geschrieben, mUssen aber aus 
KompilierungsgrUnden getrennt bearbeitet werden. 
Der LT-Schlusse! ist fur alle Detailkarten gleich. 
Das Sourceprogramm wird bei der Ubernahme resequentialisiert und aufge~ 
listet. 
Bei IDS- und COBOL-Programmen muf der Programmname im Parameter PN 
bzw. in der ersten Karte mit den Angaben in der Karte PROGRAM-ID uber- 
einstimmen, 
Anmerkung: 
~ Bereits vorhandene SOURCE -Dateien auf Magnetband (erstel{t durch 
« GAF oder MIACS -Béinder) kénnen durch die Order . GAFCONV 
Ubernommen werden. 
~ Eine bereits vorhandene Plattendatei, erstellt durch die Order .CLM 
kann durch die Order .CLMCONV auf die Source -Datei Ubertragen werden. 
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D-Karte Drucken eines Programms (80/80 auflisten) 
D, PN=pn, LT=It 
Beschreibung der Parameter siehe N~Karte. 


P-Karte Stanzen eines Programms 
A-Karte Priffen ausgestanztes Programm 


P,PN=pn,LT=It 9 bzw. A,PN=pn,LT=It 
Beschreibung der Parameter siehe N-Karte. 
C-Karte Léschen eines Programms 
C, PN=pn, LT=It, SH=sh 
Die Parameter PN und’ LT sind mit der N-Karte identisch. 
SHY oder SH=N 


Bei fehlendem Parameter wird N angenommen. 
Y bewirkt ein Verdichten der Datei in dem freigewordenen 
Speicherraum innerhalb der Sourcedatei. 


Empfohlen wird SH=N anzugeben und die Lticke in der Datei 
zu lassen. Beim Einfugen von Sétzen wird die Datei auto- 
matisch reorganisiert. (I-Karte) 

Bei eingelegtem Switch-] wird weder reorganisiert, noch der 
neve Index ausgedruckt. (siehe Anmerkung I-Karte) 


M-Karte Ubertragen eines Programms auf eine andere SOURCE~Datel, 
M,PNepn [,Lt=It FN=fr| [,OD=0d) 
Die Parameter PN und LT wurden bereits beschrieben. 
FN enthalt den Namen der Ausgabedatet, SOURCE wird be? 
fehlendem Parameter angenommen. OD ist die togische Nummer 


der Ausgabeplatte, die nicht mit der Eingabeplatte Uberein 
stimmen darf. OD=2 wird bei fehlendem Parameter angenommen, 
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B-Karte Ausdrucken des Programmindex 


B [Nu | 


B druckt einen Index der in der Datei enthaltenen Programme 
ous, einschtieBlich “STRT" und "END" -Karte. “NL" kann our in 
Verbindung mit der CTW 101 eingesetzt werden. Damit wird der 
Indexzylinder auf der CTW 101 ausgedruckt. 

E-Karte Loschen einzelner Sutze 


E,PNepn,LT=It, FR=aaoca [ ,TR-bbbbb | 


Die Parameter PN und LT sind mit der N~Karte identisch. 


*) aaaaa = gibt den ersten zu lischenden Satz an. 
bbbbb = gibt den letzten zu ldschenden Satz on. 


Alle dazwischen liegenden Satze, einschlieBlich der angege- 
benen Satznummern, werden geléscht. 
{Die Programme werden bei der Ubernahme resequentialisiert.) 


Zum Léschen eines einzigen Satzes braucht nur aaaaa ange~ 
geben zu werden. Nach dem Lischen werden die Programm= 
karten nicht resequentiatisiert . 

S-Karte Ersetzen von Satzen 
5, PNe=pn, LT=It 
Beschreibung der Parameter siehe N-Karte. 
Hinter dieser Karte liegen die zu ersetzenden Karten. 
Die im Kartenleser liegenden Sourcekarten ersetzen die ent~ 
sprechenden Karten im Sourceprogramm. Ersetzt werden die 
Karten, deren Blattliniennummer gleich ist. Abgeschlossen 


wird das Ersetzen durch eine Z-Karte: Spalten 1 ~5; ZZZZZ. 


Die in den Karten enthaltene Identifikation (Spalten 73-80 
je nach LT) muB mit dem Programmnamen Ubereinstimmen. 


° 
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Bereitstellen zum Umwandeln 
G,PN=pn, LT=It, FN=fn, OD=od 
Die Parameter PN und LT sind mit der N-Karte identisch. 


Die Parameter FN und OD werden nur bei den LT-Schlusseln 
C,F,R angegeben und haben folgende Bedeutung: 


FN=SOURCE -PROGS 


Im Parameter FN wird der Name der Source-Datei angegeben, 
auf die das Programm tbertragen werden soll. Diese Datei 
mv im 6-Bit-Mode als sequentielle Datei angelegt 

worden sein. Aus dieser Datei lesen die Compiler COBOL 
und FORTRAN und der RPG-Generator das Source-Programm. 


OD ist die logische Nummer der Ausgabestation (0 - 7). 
Angenommen werden die Werte SOURCE-PROGS und OD=2. 
Zur Beachtung! 


Die SOURCE-PROGS -Datei wird vom .GAFUPD als reine 
Arbeitsdatei betrachtet , sofern sie leer ist. 

In diesem Fall wird ein Programm immer ab dem ersten Sektor 
eingespeichert, vorher durch die GKarte Ubertragene Pro- 
gramme werden Uberschrieben. 


Sollten in dieser Datei durch andere Orderprogramme (.CLM, 
IDS) bereits Source-Programme gespeichert sein, bleiben diese 
erhalfen, eine Warnmeldung witd ausgedruckt und das neve 
Programm wird ab dem ersten freien Sektor angefgt. 


APS Programme werden ab dem zweiten freien Sektor auf 
der Systemplatte (log. 0) bereitgestellt und kénnen von dort 
umgewandelt werden (in der APS-Karte ID und OD 
Parameter angeben.) 


SPG -Programme werden ebenfalls auf der Systemplatte ab 
dem ersten freien Sektor gespeichert, einschlieBlich aller 
Zusatzroutinen. 


IDS-Programme werden auf der logischen Station 0 (SD) 
ab dem zweiten freien Zylinder bereitgestellt. Von dort 
kann die Translation durch Angabe des Parameters SI 
direkt erfolgen (siehe IDS-Orderkarte). 
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R-Karte Reorganisieren der Sourcedatei 
R 


Mit dieser Karte wird die Sourcedatei reorganisiert, d.h. 
wenn durch Lischen einzelner Programme LUcken ent- 
standen sind, werden diese durch Verdichten der Datei 
beseitigt. 

(Je nach GréBe der Datei kann das Reorganisieren bis zu 
20 Minuten in Anspruch nehmen.) 

Wenn Switch-1 eingelegt ist, wird nicht reorganisiert 
(siehe Anmerkung !-Karte). 


V-Karte Doppeln eines Programms mit neuem Programmnamen 
V,PN=pn, LT=It, NN=nn 


Die Beschreibung der Parameter PN und LT ist mit der 
N-Karte identisch ; alle Parameter sind obtigatorisch. 


Im Parameter NN wird der neue Programmname angegeben. 
Dabei ist darauf zu achten, da dieser Name nur in ent- 
sprechender Lange, passend zum LT-SchlUssel des 
Source-Programms, angegeben wird. 

Bei COBOL- und [DS-Programmen wird automatisch auch 


die PROGRAN-ID Karte getndert. 
(LT=R: 6 Zeichen, LT=F:4 Zeichen, sonst bis zu 8 Zeichen) 


*Karte Sternchen-Karte 


Durch diese Karte wird die Bearbeitung beendet, sofern 
nicht vorher eine G-Karte eingelesen wurde, 
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Es werden die Systemroutinen *STAND, *OSDS und * DFLS benutzt, 
die von diesen Routinen ausgedruckten Meldungen sind ab Seite 69 
in diesem Handbuch verzeichnet. 


2. Zusitzliche Programme 


3. Programmbeschreibung 


Das Programm besteht aus einer Reihe von Segmenten, die die 
geforderten Funktionen und Kontrollen der Detailkarten durchfUhren. 


3.1. Haltefallfe 


Haltefalle treten nur dann auf, wenn keine Schreibmaschine ange- 
schlossen ist. 


2222 Dieser Halt tritt auf, wenn eine Detailkarte mit 


(36) einem Fehler eingegeben wurde. 
Karte berichtigen oder START -Taste dricken und neve 
Detailkarte lesen. 
MN G6) Weder in der N-Karte noch im Sourceprogramm ist ein 


Name enthalten. , 


Es wurde keine STRT-Karte (APS, SPG), oder keine Karte 
IDENTIFICATION DIVISION (COBOL, IDS) gefunden. 


Das Programm ist bereits auf der Platte enthalten 
(falsche N~-Karte) . 


Das Programm ist nicht vorhanden (falsche Detail— 
karten auBer N). 


Das zu doppelnde Programm (V -Karte) ist nicht vorhanden 
{PN) oder bereits vorhanden (NN). 


Grundstitzlich wird vor jedem Halt eine Fehlermeldung ausgedruckt. 
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3.2. Arbeitsablauf 


° 


Auf einer Sourcedatei kénnen Sourceprogramme unterschiedlicher 
Programmiersprachen gespeichert werden. 

Der unterschied liche Aufbau der Karten wird durch den Language -Typ 
(LT-Schlissel) angegeben und entsprechend beriicksichtigt . 


Die Programme kénnen in beliebiger Reihenfolge gespeichert werden, 
eine Sequenzfolge wie beim Programm .GAF ist hier nicht erforderlich. 


Der Zugriff auf die Programme erfolgt Uber den in der Datei enthaltenen 
Indexzylinder, die Bearbeitung kann dadurch wesentlich beschleunigt 
werden. 


Bei der Ubernahme der Programme erfolgt eine Reorganisation der 
© | Karten in aufsteigender Reihenfolge. 


Selbst, wenn zum Beispiel durch Einwirkung héherer Gewalt die 
Dokumentationsunterlagen der Programme verloren gehen sollten 
(Umwandlungslisten), entsteht kein grofer Verlust: Durch die B-Karte 
kann der Programmindex ausgedruckt werden, dadurch kénnen sémtliche 
Programme identifiziert und gegebenenfalls neu umgewandelt werden. 


Die Reihenfolge der Detailkarten und der Einspeicherung spielt keine 
Rolle. Die Karten brauchen atso nicht sortiert zu werden. 


Ein weiterer Vorteil ist die Eingabe der Detailkarten Uber die Schreib- 
maschine, wihrend die dazu gehirenden Anderungs- und Sourcekarten 
Uber den Kartenleser eingelesen werden. Dadurch sind Anderungen 
und Arbeiten fur immer protokolliert, worauf vor allem bei Banken 
besonderer Wert gelegt wird. 


Das Ende der Eingabe bei der NeuUbernahme wird ohne besondere 
Ma8nahmen des Benutzers festgestellt: 
- Bei COBOL- und IDS-Programmen Uber die END-OF-PROGRAM-Karte 


~ Bei APS- Karten Uber den END~Befehl, gelocht ab 
Spalte 18 


- Bei FORTRAN- , SPG~ und RPG-Programmen durch eine BEND-Karte. 


Wenn eine G-Karte erkannt wird, wird nach ihrer Bearbeitung die 
Steverung an dos Operating System zurUckgegeben. 

Es kénnen, ohne das Programm neu laden zu missen, beliebig viele Uber- 
nahmen und Anderungen durchgefUhri werden. 


Eine falsche Detailkarte wird nicht bearbeitet, das Programm druckt einen 
oO Hinweis und liest die n&chste Karte. 
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PROGRAM-NAME IS TOO LONG, MUST AGREE WITH LT 


Fur ein RPG- oder FORTRAN ~Programm wurde ein Programmname angegeben 
der die maximal zuléssige Linge von 6 bzw. 4 Stellen Uberschreitet. 


THERE WERE nnn ERRORS 


fm Programm ist eine Feblerstatistik enthalten. Am Ende des Programms 
wird die Anzahl der aufgetretenen Fehler ausgedruckt. 


YOU ARE VERY GOOD, YOU HAVE MADE NO ERROR 
Es wurden keine Fehler gemacht. 
VOLUME CHANGE NOT POSSIBLE” 


Ein Spulenwechsel ist nicht méglich, das "V" im Kennsatz wird in 
ein “F" gedndert. 


NAME IN PN OR NN NOT FOUND 


In der V-Karte fehlen die Angaben in einem der oben angegebenen 
Felder. 


DUMP OF PROGRAM: NNNNNNNN 
Uberschrift Uber ein zu druckendes Programm. 
** ®* SOURCE LIBRARY MAINTENANCE * * * 
Uberschrift Uber jede neve Seite. 

PUNCH OF PROGRAM: NNNNNNNN 


Uberschrift Uber das auszustanzende Programm. Die Karten werden 
gelistet. 


FROM CAN NOT BE GREATER THAN TO 


In der E-Karte wurde im Parameter FR ein gréRerer Wert angegeben als 
im Parameter TR. 


ELIMINATED RECORDS: 


Uberschrift ber die geléschten Sdtze. 
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REPLACED RECORDS FROM PROGRAM: NNNNNNNN 
Uberschrift Uber die ersetzten Sdtze. 


I--= Karteninhalt, 80 Stellen -=-1 FROM CARD 
I--- Platteninhalt, 80 Stellen ---1 FROM DISC 


In diesen beiden Zeilen wird der zu ersetzende Satz von der SOURCE~ 
Platte zusammen mit der neuen Karte ausgedruckt. 


ZZZZZ-CARD-MISSING 


Beim Ersetzen von Suitzen oder Einfligen von Sdtzen fehlt die Absch!u3- 
karte. 


IDENTIFICATION MISSING OR MISTA KEN 


Wenn beim Ersetzen von Stitzen die Identifikation in den Stellen 73 - 80 
(je nach LT) nicht mit der Karte Ubereinstimmt, wird diese Meldung aus~ 
gedruckt. 


PROGRAM CARDS MISSING 


Wenn auf die I-Karte unmittelbar eine Z~Karte folgt, wird diese Meldung 
ausgedruckt. 


PROGRAM-ID IN PROGRAM-CARD NOT EQUAL TO PROGRAM 


Die Programmidentifikation (Spalten 73 - 80) stimmt nicht mit dem 
Programmnamen Uberein. (l-Karte) 


SEQUENCE ERROR, SORT CARDS, START AGAIN WITH I-CARD 


Beim Einflgen von Sdtzen ist in den Detail-Z-Karten ein Sequenz- 
Fehler vorhanden. Karten neu sortieren und mit der [-Karte beginnen. 


INSERTED RECORDS FOR PROGRAM: NNNNNNNN 
Uberschrift Uber die eingefiigten Karten. 


LR GREATER THAN CARD-NUMBER ON DISC 


Die zuletzt bearbeitete Karte enthilt eine Blattliniennummer, die gréRer 
ist als die letzte Blattlintennummer des auf der Platte stehenden Programms. 
(I-Karte, Z-Karte, $-Karte, £-Karte). 
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cr .GAFUPD 


4.2. Fehlermeldungen 


Nach diesen Fehlermeldungen wird die Bearbeitung mit dem Makro- 
befehl ABORT beendet. 


DU=X; NO FREE WORK-SPACE 


Auf der angegebenen Plattenstation ist kein Platz zum Bereitstellen 


des Programms vorhanden. 


FILE 1S 6~BIT-MODE 


(-) Die Datei ist im 6-Bit-Mode angelegt. Danach endet das Programm 
mit dem Makrobefeh! ABORT. (02A6). 


4.3. END-Meldung 
END OF PROGRAM .GAFUPD 


Nach dieser Meldung wird die Steuerung an das Operating System 
zurUckgegeben. 


re) SchluBbetrachtung: 

. Auf der ndchsten Seite ist ein bersichtsschema mit fast allen Programmen, 
die Sourceprogramme bearbeiten. Ferner sind die verschiedenen Funktionen 
des Programms . GAFUPD angegeben. 

Das Programm .GAFUPD hat nichts mit fertig kompilierten Programmen 
im Maschinencode zu tun, die als OBJEKT-Programme bezeichnet werden. 
Diese Programme kénnen nach wie vor mit der Order . TPG modifiziert 


werden. 

Wahrend der Entwicklung des Programms wurden einige Tests durchgefthrt, 
dabei ergaben sich u.a. bei [DS-COBOL Umwandlungen Einsparungen 

in der Umwandlungszeit von zum Teil Uber 40%. Je nach Konfiguration 


kinnen diese Werte noch héher liegen. 


° 
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Programmablaufschema 
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« GAFUSIC CONVERSION OF SOURCE -PROGRAMS 


Konvertieren von SOURCE-Programmen von einer 
SOURCE -Datei auf Magnetband. 


1. Spezifikation 


Bei einer mittleren Kartenzah! von 2000 Source -Karten pro Programm 

kénnen je nach Dateigrife 30 bis 100 Programme in einer SOURCE- 

Datei gespeichert und mit der Order . GAFUPD gewartet werden. 

Um fertig ausgetestete Programme wieder auf Magnetband sichern zu 

kénnen, wurde das Programm . GAFUSIC entwickelt. 

Die SOURCE-Datei mu8 den Spezifikationen entsprechen, die in der 
*) Order . GAFUPD beschrieben sind. Die Organisation auf Magnetband 

entspricht der Organisation der Order .GAF und . GAFCONV: 


Standard-Organisation mit Blocknummer 4005 Stellen 
Blockl&nge. 


Wegen der grofen Blockléngen sind 20 K Kernspeicher erforderlich. 


Die Order kann auf zwei verschiedene Arten angewandt werden, die 
vom Parameter CR abhiingt: 


= CR=Y Es werden nur die Programme in ein SOURCE ~Band 
eingefugt, die in Detailkarten angegeben sind, 
Dabei kann ein Sourceband upgedated werden. 


- CREN Es werden alle auf der SOURCE-DISC vorhandenen 
(7) Programme auf das im OT-Parameter angegebene 
Band gespeichert. 


Durch Anwendung dieser Order kann bei gemischter Konfiguration 
die SOURCE-Datei klein gehalten werden. Um Zeit bei der 
Bearbeitung zu sparen, sollten nur die im Teststadium befindlichen 
Programme auf der SOURCE-Platte gespeichert werden. 
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1.1. Anruf 


Das Programm wird durch die Order .GAFUSIC angerufen. 


1.2. Hordwarevoraussetzungen 


~ Kernspeichergrdfe 20 K 

~ Kartenleser und/oder CTW 101 
- Drucker 

~ zwei Magnetplatten 

- zwei Magnetbiinder, 9 Spuren 


1.3. Beschreibung der Orderkarten 


.GAFUSIC, IT=it, ck, pk, OT=ot, ck, pk, [ID=id] [,FN=Fo] [CR fila 


Bedeutung des 
Feldes 


Nummer der 
Eingabe -Band~ 
station 


Max. 
Linge 


Obligato- Bemerkungen 


tisch 


Migliche 
Werte 


Feldname 
od. Ifd. 
Schlussel 


Unpaarigkeit 


Schreibdichte 


Nummer der 
Ausgabe -Band~ 
station 


Nummer der 
Eingabeplatte 


befiebig Dateibezeichnung 


Y oder N Kartenleser, 
Detailkarten- 


eingabe 


nur 9-Spur- 
Stationen 

die Nummer in IT 
und OT dirfen 
nicht gleich sein. 


"1" wird ange- 
nommen 
SOURCE wird 


angenommen 


N wird 
angenommen 


re 
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SSRN eGS «GAFUSIC 


Aufbau der Detailkarte:-(Aufteilung in 8 Felder); 


1.3.1. Detailkarte 


Spalte 1, 11, 21, 31, 41, 51, 61, 71: 
Ab der ersten genannten Spalte kann ein Programmname angegeben 
werden, die Programmnamen kénnen in weiteren Detailkarten fort- 


gesetzt werden. 


Beginnt in einer der angegebenen Spalten die BEND ~Information, 
wird die Bearbeitung beendet. 


{st in einem Feld kein Programmname enthalten, wird eine Fehler- 
meldung ausgedruckt. 


Die Programmbezeichnungen mUssen in sequentie!l! aufsteigender 
Reihenfolge angegeben werden. 


1.4. Meldungen 

Den Meldungen wird die Nummer 81 vorangestel!t. 
2. Zusatzprogramme 

Das Programm benutzt die Zusatzroutinen 


*STAND, *OSDS 
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3. 


Benutzungsgrundlagen 


Nach dem Laden des Programms erfolgt die Formatkontrolfe der 
Orderkarte. 
Dann wird, aufgrund des CR-Parameters die Bearbeitung festgelegt: 


=CR=N: — oder CR nicht definiert, bedeutet, dai alle Programme 
auf das im OT-Purameter angegebene Magnetband 
Ubertragen werden. 


- CRY: Es werden nur die in den Detailkarten angegebenen 
Programme Ubertragen. Dabet mUssen die unter 1.3.1. 
angegebenen Bedingungen berUcksichtigt werden. 


Wenn eine BEND -Information gefunden wird, wird der Restinhalt 
des Eingabebandes auf das Ausgabeband Ubertragen und die 
Bearbeitung abgeschlossen. 


Befindet sich ein Programm bereits auf dem Eingabeband, wird es 
nicht Ubernommen. 


Das Band kann gedoppelt und auch durch die Order .GAFCONV 
wieder auf die Platte Ubertragen werden. 


Die Datei auf der SOURCE-Platte mu der in der Order .GAFUPD 
beschriebenen SOURCE-Datei entsprechen. 
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4, Meldungen und Fehlermeldungen 
4.1. Meldungen 
NNNNNNNN Jeder Programmname wird ausgedruckt. 
END OF PROGRAM .GAFUSIC 
Das Programm ist beendet. 
START OF CONVERSION DISC TO TAPE 


Beginn der Konvertierung. 


4.2. Fehlermeldungen 
Im Fehlerfall erfolgt ein Halt auf der Adresse 2222. 


PROGRAM NNNNNNNN MULTIPLE ON SOURCE-FILE 
NEW INSERTED 


Das in der Fehlermeldung angegebene Programm befindet 
sich bereits auf dem SOURCE-Band . Nach dem Halt auf 
der Adresse 2222 wird das Programm von der SOURCE-Platte 


neu Ubernommen. 
CARD ERROR 


In der Parameterkarte ist ein Feld ohne Programmnamen. 
Es erfolgt ein HLT“auf der Adresse 2222, nach Betttigen 
der START-Taste wird das néchste Kartenfeld bearbeitet. 


PROGRAM NNNNNNNN NOT FOUND 


Ein in der Detailkarte angegebenes Programm ist nicht 
in der SOURCE-Datei enthalten. Nach Betttigen der 
START -Taste wird das nuchste Kartenfeld bearbeitet. 


OVERFLOW ON SOURCE-FILE 


Das Ausgabeband reicht zur Aufnahme des Programms 
nicht aus. Das letzte Programm ist nicht vollstandig 
Ubernommen worden. Die Bearbeitung wird nach Be- 
tdtigen der START-Taste beendet, das SOURCE -Band 
wird abgeschlassen, 
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FILE NOT FOUND 


Die im Parameter FN angegebene Datei wurde nicht 
gefunden. Die Bearbeitung endet auf der Adresse 02A6. 


PROGRAMM NNNNNNNN NOT IN SEQUENCE 


In der Detailkarte wurde ein Programm gefunden, dessen 
Name kleiner zum vorhergehenden Programmnamen ist. 
Das Programm wird nicht berUcksichtigt, die Bearbeitung 
wird mit dem nichsten Kartenfeld fortgesetzt. 


AuBer den oben ongegebenen Meldungen und Haltefillen kinnen 
auch Meldungen der Zusatzprogramme *STAND, *OSDS und 
Haltefalle aus dem EIOS auftreten. 
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3. 


3.1. 


G=118/120/130 


Anwendungsnormen 
Funktionslogik 


Da in der Orderkarte kein Dateiname angegeben ist, richtet sich der Name 
der wiederhergestellten Datei nach dem Kennsatz auf dem Band. (Das 
Programm .ED99DF Ubernimmt den Plattenkennsatz auf das Band.) 


Die Wiederherstellung des Platteninhalts erfolgt ohne Rucksicht auf die 
Satzkennschlussel sektorweise. Ein Bandblock wird auf die Sektoren der 
Platte verteilt. 


Grundlage fur die Adressierung bildet die Angabe “erster reservierter Zylinder” 
im Plattenkennsatz. . 


Eventuell vorhandene Kurzklécke werden nur auf die entsprechende Anzahl 
Sektoren geschrieben, da nach jedem Blocklesen eine Errechnung der Block ~ 
lange erfolgt. 


Beim Zylinderwechsel wird die Angabe “letzter reservierter Zylinder" 
im Plattenkennsatz Uberprift. ist dieser Zylinder Uberschritten, erfolgt 
eine Fehlermeldung und der Abbruch des Programms. 


Nach dem Erkennen des ersten Endblocks wird zuniichst die Endadresse des 
Schreibens in den HDR der Platte eingesetzt und dann das Band weiter- 
gelesen. Ist der n&chste Block eine Tape Mark, wird eine evil. angezeigte 
Belegung der Overflow-Zone geléscht und das Programm beendet.-Wenn 
noch Blécke der Overflow-Zone auf dem Band gespeichert sind, werden diese 
Ubertragen und bei Bandende der Plattenkennsatz upgedatet zurUckge- 
schrieben. Danach wird das Programm beendet. 


Anmerkung: 


Bei indiziert-sequentiellen Dateien mu8 der Indexzylinder nev erstellt 
werden, da er nicht mit auf Band Sbernommen wird. 
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Hinweise fur die Benutzung des Indexzylinders 


Bei den Plattenstationen DSU 110/160/162/150 wird ein Zylinder fur den 
Index benutzt. 


Bei der DSU 157 werden zwei logische Zylinder benutzt, der zweite Zylinder 
wird durch die Order automatisch zugewiesen. Es sollte aus Zeitgrinden 
darauf geachtet werden, daf der erste Indexzylinder mit einer geraden 
Nummer beginnt . 


Aus Softwaregrinden darf bei den Plattenstationen DSU 110/160/162/150 
*) eine sequentiell indizierte Datei erst mit dem zweiten Zylinder beginnen. 


Bei der DSU 157 darf eine sequentiell indizierte Datei erst mit Zylinder 4 
beginnen. Die Zylinder 2 und 3 kénnen jedoch den Indexzylinder aufnehmen . 


(Random~ oder starrsequentielle Dateien kénnen mit dem Zylinder 1 an- 
fangen, IDS-Dateien missen mit dem 1. Zylinder beginnen). 


Bei der DSU 110/160/162/150 erfolgt die Generierung des Indexzylinders 
durch das Programm INDEXING. 


Auf der DSU 157 muB das Programm INDEX157 benutzt werden. 


Zur Bearbeitung des Indexzylinders wird auf den Stationen DSU 110/160/ 
1 162/150 das UP YINDX verwendet. 


°°. Auf der DSU 157 wird das UP YIND7 benutzt. 


Programme, die sequentiell indizierte Dateien bearbeiten, miissen somit 
auf der DSU 157 neu umgewandelt werden. 


Die Auswahl des entsprechenden UP’s erfolgt durch die Kompiler automatisch, 
wenn der entsprechende Parameter angegeben ist. 

APS-Programme kénnen auf der DSU 160/1462/150 umgewandelt werden, 

wenn der Parameter DV= 157 angegeben wurde. 
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° SGE 
~—F TT 
Fetdname od. | Obiiga- | Maxim. Lee 
Mégliche Werte Bedeutung des Feldes Bemerkungen 
Id-Schlissel 
ET=et nein 1 ET=F ader ET=V Angabe fiir den Abschlug | Wenn nicht angegeben, 
F=EOF / V=EOV wird ET=F angenom- 
men. 
| BS=bs nein 4 1-9999 Anzahl zu iberlesende —_| Fir das Uberlesen von 
Bidécke VOL, HDR und TM 
braucht BS= nicht 
oO spezifiziert zu werden. 
NB= nein 1 NB=Y oder NB=N | Angabe Blocknumerie- |Sollen die Blocke 
rung: NB=Y: Bldcke numeriert werden, 
sind numeriert missen ET=F und 
NB=Y angegeben 
NB=N: Blécke sind 
werden. 
nicht numeriert. | 
2. Zusatzprogramme 


In der Basisplatte ist das Vorhandensein der Order SPVAUXM erforderlich, die die 
UP’s *IODC, *STAND und *OSDS enthalt. 


Oo 3. Benutzungsgrundlagen 
3.1. Eingabe von Karten 
Fir die Order .SGE sind folgende Detailkarten vorgesehen: 


— #SBL (Start Block} 


Diese Karte mu vor den BLK-Karten liegen, die die Blockdaten enthalten. 


Spalte 1- 4: Identifikationscode #SBL 
Spalte 5 - 80 : unbenutzt. 
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LIBRARY RELEASE MANUAL 


relating to: G118 - 120 - 130 - 130 - 127 - 131 


TILE Distribution of programs contained in: 
ETOS (Extended Tape Operating System) 
EDOS (Extended Disc Operating System 


OBJECT 


This version cancels and substitutes the previous 
one and contains: 


List of modified programs with brief description 
of the variations. 
Error signals and/or known limitations. 


The documentation provided for new products is 
attached and the updatings to the documentation 
contained in the previous version. 


Next Distribution : not planned 
Version : ET025 


ORIGINATED BY Technology and Service Programming 


Distribution Lest updared 


January 
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ASSEMBLERS AND COMPILERS 


Limitations and Corrections) 
«APS (ZDOS) 
-APS_(ETOS) 
«COBOL 
. FORTRAN 
» RPG 
~sPG (ETOS) 
-SPG (EDOS) 
-IDS 
-TAB 
.TG1 = .TGF - .TGG — .TGP - 


«APSP 


UTILITY PROGRAMS 


(Limitations and Corrections) 


DISK DISK 
INDEX 157 

CTDISK 

-TDISKi = .TDISK2 - .TDISK3 
T130_- 160 

cOSAE1 (HIST personnel usage 
SVGLOAD - SVG _157 
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PRODUCTS NOT DOCUMENTED IN 
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ET025 FIELD REPORTS 


Field Reports corrected : 


Field Reports to which a limitation has been made 
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Picid Reports situation in ET025 
A correction has been made to the following Field Reports, 
ETOS ORDERS: 


-SPD. 313093 
.STG 209097/210109 
»TDC 211115 


EDOS ORDERS 


.DTDFT/.DTAFT { 228318/228300/245488/230334/305024/305025 
+DTDFA/.DTPFA | 216188/212144/245485/312080/321139/321137 
-DTPFT/.TDAFT a 

«TDDFT/,TDPFT 


+ED99 319096/318117 

«MDG 215179 

SPVAUXM 313090 

.TPG 225273/ 245490 

.SYS 328177/339253/243466/319125 
. SVG 330198 


SUBPROGRAMS 


EIOS TAPE 710547/302008 (YcLoss) - 710547 (ycLous) 
228306 (YOPN) - 710547 (YcLcss/YcLcus) 


EIOS CARD 
READER/ PRINTER 


{ 330201 (YPUTPC) 


CARD READER 230337/330197 (YCRZ2) 
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CARD PUNCH 248522/338242 (ycoPz1-6) 

CARD READER PUNCH 248522 (YCRP1-8) 

PAPER TAPE 236393 (YPTR4) 

BOS . 222250 (YTC11) - 212137 (YRNSH) 

Ips 330192 (YQOPEN) 

COBOL 302001/312083 (YG#01) - 309055 (YEV130) 

BDTR 321145 (YCASEG) - 312073/312075/325161 
(YENBL/YESQMB/YESQML/YFAT/ YMDMRI/YMDMRO/ 
YOPENY/YPROC/YSTAMP/YPROBA/ YWHOS ) 

ASSEMBLERS AND COMPILERS 

«APS 327165/32144% /248516 

«COBOL 710127 /207073/211132/224271/230334/243458/ 
309058/232374/ 305028/209049/710268/309054/ 
2384 18/250546/312085/330196/324155/315114/ 
334228/330190/330192/315114 


«FORTRAN 3BOTO43 


«RPG 305020/334217/248536/25 1555/321135/250543/ 
312079/318121 


315105/327166/318116/321143/322150/329183/ 
330202 


207080/ 330192/ 248520 
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334221/321147/230353/320132/ 245489 


UTILITY PROGRAMS 
DISK DISK  248532/307035/307039 


INDEX 157 228316/327162 
cTpIsk 318120 


A limitation has been made to the following Field Reports. 


.MTS 232379 
.SLCK 321142 
YP85B 334218 
. APS 328187 
oO . COBOL 228307 /307044/303013/227296 


«RPG 2NNN7 6 
-IDs 334215 
SVGLOAD 

sve 157 | 334223 
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System improvements in ET025 


EDOS improvement 


It may handle 7 tracks controllers 


MTC 104 
MTC 114-110-114B-110B 


Personalization is obtained by indicating in .SVG the code 


M7TC104 
MTC 114 (also for MTC 110 - MTC 1174B - MTC 110B) 


With MTC 104 it must be requested a special version of .INT 
which assigns the logical numbers of the tape units (object 
program available on cards). 

APS 


The files table has been broght from 501 to 1439 characters, 
for programs loaded in coexistence/alternance. 


-TAB - EDOS 


Compilers and object programs may be executed in 48-64K and 
in bi-programming as the main program. 
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ETO25 limitations and specific notes 
.MTG 


When loading with .PRL a program in master mode, there are no 
checks on the serial numbers of the file both when reading and 
recording. (F.R. 232379). 


2SFD 


Warning 


In the versions preceding 72064 it was not possible to detect 
the overlapping of the last cylinder of the overflow area with 
the amin area. The user must be very careful in order to avoid 
the use of the versions having this mistake which generates 
greater errors when handling the files and the free area table. 


~SLEK 


During checking phase, the .SLCK order signals as double the 
following subroutines: YP1T03, YP103, YP85, YLBSB,-YDFLS, YLFQV; 
in addition the non-existing YDCP routine appears. 

These subroutines are in the library because of previous wrong 
strip but are not pointed by the index and therefore do not 
disturb. 

Because of this situation even the last 7 subroutines are not 
tested and listed (F.R. 321142). 


¥P858 


It does not work during restart phase and the final call will be 
as follows: SUBY85B + 388 (F.R. 334218). 


acme. | 
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-APS (EDOS) 


It is not possible to check the .APS FILE as the check may only 
be executed by macros (F.R. 329187). 


COBOL 


DISPLAY: 


When printing several constants, if the character " (quotations) 
is errouneously written there will be a wrong generation of the 
object program without error signal (F.R. 303013). 


SUBROUTINE 


If a special subroutine (¥....¥) is assembled in a non-resident 
segment there will be a wrong allocation of the subroutine itself 
in the memory. (F.R. 228307). 

This limitation will be eliminated in £T026. 
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The following result: 
IF POSITIVE, IF NOT NEGATIVE 
IF NEGATIVE, IF NOT POSITIVE 


is not the same if the field contains character 0 or 0W 
(F.R. 227296). 


LOOP_IN COMPILATION 

If a type 01 level is not indicated (missing punch 1 or Q) the 
compilation goes into loop (F-.R. 307044). 

TAPE FILES 

If a tape is not enough to contain the data of a file declared 


monovolume the tape will be processed until the end. 
It is advisable to use MULTIPLE REEL clause. (F.R. 251553). 


| ee | a | 
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SYSTEM | PROGRAM 


- TAB 


ETOS/EDOS Limitations 
- It is not possible to compile in TAB the programs whose code 
is composed of the word "END" in column 224. 

° EDOS Limitations 
- When punching tables on cards, it is necessary to use partial 
segmentations (col. 34 card x = N). 
SVG LOAD - SVG 157 
It does not allow the use of buffered 1531/2 (the limitation will 
be eliminated in ET026) (F.R. 334225). 
-IDS 


The translator does not signal the error 
on level 0} (F.R. 334215). 


«RPG (ETOS/EDOS 


° If a "FIELD RECORD RELATION" is associated to the control level 
fields, note n. 158 is given incorrectly. The good functioning 
of the program is not compromised (F.R. 244476). 
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GENERAL ~- EXTENDED TAPE OPERATING SYSTEM 


SYSTEM | | 


The System Tape is usually distributed on magnetic tape personalized 
for the configuration of the user registered on 7 or 9 tracks. 


However, when the System Tape is not personalized, it is possible to 
effect the personalization in two different ways: 


- With the .STG order that is found on a personalized System by, 
during the rewinding of this, putting in Step-by-Step after the 
input of the .STG order card, then substituting the System to be 
personalized with that already personalized, and continuing the 
processing until the end of generation. 


- With the STG LOADER program (see p. A 03). 


NOTE 


°o - is not possible in ETOS environment to perform a CHECK 
POINT on a 7-track tape unit, 


- Possible COS/BOS/TOS subroutines not included in ETOS can 
be inserted by the users by means of source cards that can be 
furnished on request. 


The insertion must be performed by compiling the subroutine 
with the . APS order and inserting it with the .SLI order. The 
STRT card must head the initial program at address zero, 
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G 115 = G 2730 Compatibility 
Hardware Compatibility 


With the same peripheral configuration, all kinds of G 115 
software packages work on G 130 without any modification, 


° Software Compatibility 


Object program compatibility. 

User programs working on TOS 115 can be transferred on ETOS G 130 
without any modification, 

This is done from G@ 115 Library Tape to G 130 Library Tape, 
using ETOS 130 LDP order. 


Programs which foresee the use of .RST are excluded, these must 
be recompiled (see the notes given below). 


Of course, the programs which use magnetic discs are not to be 
taken into consideration, as ETOS does not handle magnetic discs. 
User programs working with DOS 115 cannot be used on EDOS 130 
due to the different disc format. 


APS ~ ETOS program compatibility 
t*) TOS programs 


User programs written in APS 115 can be recompiled with APS 130 
without any alteration, 

Anyhow, it will be necessary to change the program starting 
address, punched on START due to the larger memory occupation 
of the ETOS resident section compared to TOS. 

This fact may give rise to some problems when: there are programs 
using absolute addresses of the main memory. 

Programs, which are only recompiled, do not use any of the G 130 
facilities; they just Have a higher processing speed. 


, 
Honeywell ATTACHMENT TO STL wlelr|o le 2. oF FLW. [ | rege [al ai 2 


Honeywell Information Systems lala 


DOS Programs 


User programs written in APS II 115 can be recompiled in APS IT 130 
without any modification when the disc files require only sequential processing 
of sequential files. 


It will be necessary, in this case, to modify the program starting address and, 
besides, it will be advisable to change the dimension of the disc file pages, 

in order to avoid wasting disc memory. For example, a page of 400 charac— 
ters (6 bit), while it is optimized on DSU 130, can be remarkably expensive on 
DS 161. 


For programs that use the random or mixed processing of sequential files, 
the above applies. Besides, it is mandatory to modify the page length so that 
the number of sectors per page used in random mode is a sub-multiple of 20. 


° For programs that use the random processing of random files, the above - 
applies, but it will be necessary to modify the formula which transforms the key 
in dise addresses, . due to the different structure between DS 161 and DS 130 
discs, 


rere 
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SYSTEM { | PROGRAM a eer luge a ETOS/EDOS 


NOTES 


*TAPE 
- After reading of a T.M.the address in 254/255 ia not the address 


following the last character introduced in memory. 
oO The limitation will not be removed. 


*LBSS 


~ It must not be used, even for card reading only, when printing 
*PRINT or"FILE"or card-reader *READ or'FILE' are used. 


- The end of page cheek is executed before printing and/or paper 
° movement. 


A system tape generated by a certain density cannot be duplicated 


and used at another density; besides, the ST must correspond to the 
maximum density of the unit en which it is used. 
The only exceptions admitted are between density 1600 and 800 b.p.i. 
in GUN MF. 

C#) This note is also valid for Master Tape. 


Mod. 502 /4 
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PILOT 0 


The system is initialized with the PILOT ZERO card here attached, 
which searches for the first block of the supervisor on S.T. or M.T., 
launching Pilot 1." 


The attached pilot handles the S.T, or M.T. mounted on U.N, 8. To work 
with the S.T. or M.T. on tapes1, 2, etc., substitute the underlined charac- 
° ters 00 with 01, 02, etc, 


9>0 00229>0 DOZ49>0 00189504009>43>000049>0 0026024043200308437 0000080448047804T 


CooOMONM Ao coM MN coccM cREccoocMSMN cc oN oDG coM ooBoc cM oBo occ MARR o Moo oMscckca 
1 989M C58 94M TD mw 2812222 MB 2070 HAI 32 8 HTH 40 2 044 45 46 ANAM SESSA SSSESN 9 SOED EGR 54 BS SBGT SAAD TO 272 1478 TTD 
TERERERREEERERES) RERORERRECRSORRREEEOUEOERRERSSOSEEEOEESSRREEREEOEESRERE ES 
222222MM222222M22222222222272222222 222222222220 220222222222 2222222222222222272 0 
23343933333993333939433313333333909293333933333393933093903930999393999999339933 
us 


SSSSSSSSSSSSSSSSSSSSSSSSSMSSSSSSSSSSSSSSSSSSSSSSSSSSSSHSHSSSSHHESSSHSSSSHSSSSSSS 


PUUCUCEUURCOCES) CECCCCECESEL OCCs Peete! Cece cecal Fi CQOCeees COCeeeees | Cee 
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SHCCUSCCCNCOCEGSCMSC CSG CEES COGS S CMG CR ECC CEG SONG SCE SGCSCECC CEE SECC ESE GSESEGCSCE 
LP ESEEEDEREEERPEERESESOEERESED! SESESEEREREESEESESEREPESISEEEE. ISPEESEREREL DERE! 
ebsezasceMasessasMeagsameacas EeMaspassMiscraggresessaesedeshessscheasMaas Meal 
g MssggsecHgasgsssMag9asaGMaasaassaeasssaGMSusSIISasNTISIISTISITIIITSITIIITIITIING 


423 4 5 be 920M HEN HS Um MF 89 20-24 227026 25 ab AY T4200 3032 2534 959837 39-404 42 9 45 AG AAG 205182 9 5055-4 SD S96 6102 GOO EEG ETCE ED TO TL RTE IGT TED 


\*] 


If using T code, change the characters according to the following table: 


H code T code H code T code 
0 8 9 
a) Z (9-6) 
C (8-2) ¥ (9-8) 


H®-3) X (9-4) 
@-4) W (9-3) 
: (8-8) V (9-2) 
> (8-6) U (9-1) 
2 (8-7) T (9-0) 
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.STG LOADER 


The program is composed of three types of cards. Cards with 0i in 
Column 79/80 which constitute the true program, and cards with 54 and 
56 (Col. 79/80), corresponding to the .STG ETOS segments containing 
the tape routines: 


° 54 = 7/9 controtler 
56 =M.F. controller 


Therefore, before using the STG LOADER, it is necessary to eliminate 
the segment corresponding to the tape routine which is not pertinent. 


Moe er Tt 
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EXTENDED DISC OPERATING SYSTEM = GENERAL 


7 EDOS System Disc listings are attached to the STL and are 
divided as follows: 


DSU_160 = it contains: 


complete version plus BDTR file, 


DSU_7110 


Disc A - it contains: 

«COBOL, .IDS, subroutines library and the following orders: .INT, 
»API, .DHW, .SPVAUXM, .LOAD, .SFD, .PFD, .DFDL, .SVG, .PTR, .PSTR, 
-CSI, .SSTR, .LIST, .PFCP, .STR, .MDG, .ED99, FILE-INT. 


Dise B - it contains: 
«RPG, .RCA, all the orders, DATACONV, FILE-INT. 


Disc C - it contains: 
-TG1, .TGG, .TGF, .TGP, .TGS, .TAB, .SPG, .APS. 


Disc D = it contains: 

the new products: .ENDPT, .PRT, .SCIFT, «TIMEOUT, .BDTT, TPCONVE, 
TPCONVEM, TPCONVU: VIP subroutines of SOGET; the orders: .SPVAUXM, 
»ED99; the compiler .FORTRAN and the utility programs: INDEXING, 
DISK DISK, CTIDISK, DPRINT. 


psu_162 


Disc E - it contains all but: 
»COBOL, .FOR, .TAB, .TG1, .TGG, .TGF, .TGP, .TGS, .IDS, .RPG, 
«APSP, .TESTMON, 


Disc F - it contains all but: 
DATACONV, LTDISK1-2~3, INDEX 157, BDTR file, T130-160, .APSP, 
»TESTMON and the new products, 


Dise cylinders occupation is: 


Disc A: 39 cylinders (about) =- Disc E: 60 cylinders (about) 
Disc Br: 39 cylinders plus 33 cylinders for 
Disc : 31 cylinders BDTR file 

Disc D: 28 cylinders - Disc F: 98 cylinders (about) 


NOTE: .APSP and .TESTMON are available on DSU 160 only. 
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Procedure to obtain a §.D. DSU 157 starting from 
EDOS T-TAPE A file 


On the disc obtained from Transport Tape (EDOS file) on 

DSU 157, it is not possible to delete correctly (with .DFDL)} 
the occupation of the index cylinder of the TDISK1 file, 
because the EDOS file is obtained from a DSU 160. Therefore, 
it is necessary to execute the following operation: 


transfer the program file from the disc obtained with D157 
program to a second DSU157. 

If the file TDISK1 containing BDTR is to be used, besides the 
operation previeusly described, it is necessary to: 


1) define file TDISK1 in this second disc 

2) transfer file TDISK1 from the first to the second 
DSUL57 by means of utility program DISKDISK; 

3) finally, generate on the second DSUL57 the index cylinders 
for file TDISK1 by means of ytility program INDEX157. 


Procedure to obtain a §.D. DSU1SO/DSU162 starting from 
EDOS T-TAPE A and B file 


The System Disc obtained from a Transport Tape A or B for 
DSU150 and DSU162 respectively, needs an updating of label 
VOL1 and the free area table, since the NS99 program 
generates it as if it was a DSU160. 


The procedure is the following: 

from the disc obtained with program ND99 transfer the programs 
file on a second DSULSO/DSU162. If TDSKi file containing 

BDTR is to be used, besides the operation described previously 
it is necessary to proceed as follows: 

1) define in theis second disc the file TDISK1 (.SFD) 


2) transfer the file with utility program DISKDISK from the 
first to the second DSU150/DSU162 


3) generate on the second DSU150/DSU162 the index cylinder 
for file TDISKL ‘with utility program INDEXING. 


NOTE 


It is not possible to use a supervisor generated by a previous 
version of .SVG with the present software or vicewrersa, 


° 
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SYSTEM [ ] 


PILOT ZERO 


The system is initialized with the EDOS PILOT 0 card that searches ou 
the S.D. or M.D. for the first block of the supervisor and launches the Pilot 1. 


The PILOT 0, attached, works with S.D. or M.D. mounted on Unit 1 

for the controller, connected to the comector10. To work with S.D. or 

M.D. on Unit 0 or 2, ete., substitute 11 withi0, with 12, ete. The same 

operation must be done if the DSC has a different channel (ex. 20) for 

which it will be necessary to change card 11 with 21, 20, 22, et 
<5 ey ttre ey . 2A ae acer 
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SSSSSHSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSHSSHSSESSSSSSSHS MES HSS SSSSSS 
CMEC SSGGMSSSEGCENSG EGC ON SEC ECS EGCG ONGC CSSCCEECSESECSSSEGSSEMS SECC GEG CMEGGESCSS 
ERERPEREEERERESEESERESERERERERISSIELEL LEG) POSESESESEEREDERA CEL ISEEL LERREREEEEEE | 
eMigcosagMsassareMagecgMeManscangacastasseMrsseanegespecsesheeteMsacssssMagnsasa 
MoacosogMosgaggsMasaaag Mo gang asgssagsegaggsgTGgTRIIIINIGIIITIGHITITIVIITGTINRS: 


PErPrereliriiiitiittrtiriitt litter ire ririi iii Cite Een COLO OL LE EEE EE ELE) 
if using T code, substitute the various characters according to the 
following table: 


we 


H code T code H code T code 

0 K 8 9 

1 6 9 Z (9-6) 
2 5 C @-2) ¥ (9-5) 
3 4 (8-3) X (9-4) 
4 3 (8-4) W (9-3) 
5 2 : (8-5) V (9-2) 
6 1 > (8-6) U (9-1) 
q oO ? (8-7) T (9-0) 
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SVGLOAD - Launching from cards of .SVG program 


° 


+) The personalization is not allowed with SVGLOAD of previous editions. 


The program is usable only with 110/160/162 discs, For 157 discs SVG157 
program code ED98 is used. 


fe] 
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SYSTEM | } PROGRAM 
The .STG program contains all the basic routines that are inserted in 


.STG - Segment Contents 

the basic program, according to the configuration of the system. It is 
composed of 84 segments, of which the first twa compose the actual program 
and the others the various routines, namely: 


Routine BIOS 115 


Segment 4 * LBSS CRZ100/CRZ120 - PRT 110, 111, 142, 143, 144 
146, 160, 163 H code 


" 5 * LBSS CRZ100/CRZ120 - PRT 120, 125, 130, 145, 148, 
149 H code 

He 7 *LBSS CRZ100/CRZ120 - PRT 118, 119, 120, 125, 130, 
145, 147, 148, 149 H code 

af 10 *LBSS CRP100 - PRT 110, 111, 142, 143, 144, 146, 160, 

163 H code 

Me 13 *LBSS CRP100 - PRT 120/130 H code’ 

BU 28 *LBSS CRZ101/CRZ121 - PRT 110, 111, 142, 143, 144, 
146, 160, 163 T code 

2 29 *LBSS CRZ101/CRZ121 - PRT 120, 125, 130, 145, 148, 


149 T code 


CRZ101/CRZ121 - PRT 118, 119, 120, 125, 130, 
145, 147, 148, 149 T cade 


CRP101 - PRT 110, 111, 142, 143, 144, 146, 160 
163 T code 


CRP100 - PRT 120/130 T cade 


Call segment 
. MTC 103/MTC 106/MTC 103B/MTC 106B/MTS 101/111 
MTS 163 +173 
Supervisor CALL 


Wad. eset 71 
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Routine BIOS 120-130 


Segment 61 *MTAPE MTC 103/MTC 106/MTC 103B/MTC 106B/101/111 
" 63 *MTAPE MTS - 163 +173 

ff 66 * PRINT PRT 110/111/142/143/144/146/160/163 
67 *PRINT PRT 120, 125, 130, 145, 148, 149 
*] " 69 *PRINT PRT 118, 110, 120, 125, 130, 145, 147, 148, 149 
" 12, * READ CRZ 120 H code 

" 13 * READ CRP 100 H code 


" 16 * READ CRZ121 T code 
" 17 * READ CRP 101 T code 
% 80/81 *TAPE LBSS Serve BIOS GE 120 - GE 130 H code 


82/88 *TAPE LBSS Serve BIOS GE 120 ~GE 130 T code 


The unused segments are available for other Basic Routines. 


‘Med. 0502 [1 
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.TPU 


Limitations 


The order cannot generate S.T. 's which have more than 188 programs of type 
oO lor3(F.R. 710622), 


-PRL 


Limitations_ 

With the COBOL compiler it is not possible to use the option "print trace " 
° (P in Col. 14), 

.DPG 


Limitations 


In a program in which two subroutines are inserted, if in the first subroutine 
re) a printout of an area contained init is requested, such request will not be 
executed. 


2MDP 


NOTE 


To print the SRA it is necessary to use the COS memory dump program 
(cod. 0201). 

To print the part of SRA preceding the 01C0 address, it is necessary 
to use the COS memory dump program (cod. 0219). 


«MTG 


Limitation 


° When Joading with .PRL a program in master mode, there are no 
checks on the serial numbers of the file both when reading and 
recording. (F.R. 232379). 
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Corrections 

2 GAF 

If loaded by SD, it ised to go into ABORT when a WD declarative 
-INT was executed before a source extration. 

-RST 

The possible memory area contained between the end of the 


supervisor and the beginning of the program, was not reset. 


»SPD 


When .APS was cancelled in the system the following message 
was given at the end of the tape: 


1004 x UNIT 8 : PERSISTENT ERROR (F.R. 313093). 


~S5TG 


XREAD PRT 120-130 
Incompatibility with 157/2 of the commands: 5046 and 504A 


(F.R. 209097/210109). 

xTAPE MODE 115 

Error possibility in case of noisy TM during continuous hack~ 
reading. 

xLBSS MODE 115 CRZ-PRT 118 

Absence of YLB2S jump. 

-TDC 


It duplicated a TM in the case of a starting CHKP (F.R. 211115). 
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-CDP - Card Duplicate 


Limitation 


The order does not work with CRP used as a system peripheral. 


_DHW 
Limitation 


During initialization of discs DSUI10, more than 6 alternative 
tracks may be assigned. , Pa ‘ 
Therefore it is necessary to visually check this condition in the 
printout of the assigned alternative tracks (Correction for E1025). 


.SFD 


Warning 


In the versions previous to 72064 the overlapping of the last 
cytinder of the overflow zone with the first one of the main 

area, was not detected. The user must be careful in order to use 
versions without this error which generates errors in handling the 
files and the free area table. 


«SLCK 


Limitation 


During checking phase, the .SLCK order signals as double the 
following subroutines: YP101, YP103, YP85, YLBSB, YDFLS, YLFQV; 
in addition the non-existing YDCP routine appears. 

These subroutines are in the library because of previous wrong 
strip but are not pointed by the index and therefore do not 
disturb. 

Because of this situation even the last 7 subroutines are not 
tested and Ttisted (F.R.- 321142). 


Wok oma Jt 
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SVG 


° 


The .SVG program contains all the basic routines that are 
inserted in the Basic Program, according to the configuration 
of the system. It is composed of 62 segments of which the _ 
first four represent the real program, and the others contain 


the various routines, namely: 


BOOSTRP 


Segment 5 

" 6 PILOT 1 
7 
8 


xCALL Supervisor 

xPRINT for integrated printer 

xPRINT for buffered printer normal chrts. 
5 il #PRINT for buffered printer CMC7 chrts. 

si 14 zREAD for Hollerith CRZ120 

Ws 15 ®READ for Hollerith CRP100 

bts 18 XREAD for CRZ121 Bull 

id 19 xREAD for Bull CRP101 

bs 22  xMDP Routine 

tt 23 xDNA Routine 

ad 24 xCALL Segment feed 

ue 25 xDISC routine for DSU160/110/162 

is 26 xDISC routine for DSU1S7 

ni 28 XPILOT 2 

hig 30 TAPE for GUN 7/9 (Hollerith) MTC101 

= 32 xTAPE for GUN M.F. (Hollerith) MTC160 

ad 34 xTAPE for GUN 7/9 (Bull) MTC161 

"36 xTAPE for GUN M.F. (Bull) MTC160 

ue 37 RMSG+RLBSS with tapes (Hollerith) 

_ 38  xMSG+xLBSS with tapes (Bull) 

ie 39 xMSG+xLBSS without tapes (Hollerith) 

40 xMSG+xLBSS without tapes (Bull) 

: 41 Routine xTAPE+xLBSS without tapes (Hollerith) 
E 42 Routine xTAPE+xLBSS without tapes (Bull) 
43 Routine xTAPE+xLBSS with tapes (Hollerith) 
" 44 Routine xTAPE+xLBSS with tapes (Bull) 

4 45  oRMSGtxCTW 16K version 

id 46 Fixed constants, resident supervisor 

" 47-66 OPENCLOSE 


oO 
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Corrections 
-DTDFT/.DTAFT/.DTDFA/.DTPFA/.DTPFT/.TDAFT/ .TODFT/ .TDPET 


- It was not possible to use discs DSUI57 (F.R. 228318/228300/ 
312080/321139/321137). 


It was not possible to continue processing when the tape unit 
gave the out of service signal (F.R. 245488). 


. A wrong density code of the tape caused the out of service 
@] on the tape unit (F.R. 230344). 


When there was a 6 bit file allocated in the last blocks, the 
program .DTDFT did not transfer correctly (F.R. 305024) and 
the first zone of the label free area contained a wrong code 
(F.R. 305025). 


In the case of random or sequential with index file, it did not 
write the last two tracks correctly (F.R. 216188/ 212144). 


e It did not write the overflow zone correctly (F.R. 248485). 


~ED99 


In the case of DSUI57 and programs file than 200 cylinders, 
the program stopped; furthermore the parameters card checks 
were missing (F.R. 313096/318117). 
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-MDG 


When loading a master chain with pilot 11 and logic unit zero off, 
there were HALTs for wrong calling of the logic unit zero 
(F.R. 215179). 


SPVAUXM | 


x stand did not consider the "," comma in decreasing the card 
length, therefore there could be unexisting error signals 
(F.R. 313090). 


o 


~TOP 


A wrong block length was printed when a TM was encountered. 


1PG 


° PROGRAM INDEX OVERFLOW signal has been eliminated since it used 
to be given erroneously even after corrections were made 
(F.R. 225273/245490). 


z When parameter NP = Y was expressed the coexistent program did 
ro] not exchange with the current program, as it entered a loop 
of SPV without exiting (F.R. 328177). 


When pressing input in coexistent enviroment twice, and also 
pressing .CTRL-XOFF, a wrong message was given and the program 
went into INVALID ADDRESS (F.R. 339253). 
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- In alternance/coexistence it is now possible to have a tele- 
handling program with a files table greater than 500 positions 
(F.R. 243466). 

- Whe the concurrent used the system reader, it gave the reader 
control to the same and the message "PERIPHERAL UNITS NOT 
AVAILABLE" was not given. 


SVG 


- When working in EDOS environment with DSU157 or H273 it was not 
possible to assign logical numbers to the physical units 
through the order card, since the same logical numbers correspond 
to the physical numbers expressed by the clusters. 


- Wrong jump instruction MVIO,DEVSEG (F.R. 330198). 


Mo 300 7 
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DESCRIPTION 

Check of alphanumeric field 

Create normalized pages of program 
YDFL5 Label search for data files 
YDPFCY Print data from dise 
YDTUP Update date 
YDZRR Restore or request disc zone 
Y¥FDTUP Update file table ? 
YHXCK Check hexadecimal field 
YIOTC Check input and output tapes 
YOPCK Subroutine of object card. checking fields 
YOSTP Tape subroutine of the operating system 
YPFSH Shift of programs file, 


Label search in the program list 


Search addresses relocatable in a program page 


Subroutine label search 


Loads the user's address 


Displacement of one or more segments 
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The subroutines exist now in two distinct versions working respectively 


EIOS TAPE 
only in ETOS and only in EDOS. 


fe) 


DESCRIPTION 


YC LOSN Closing of a non-standard file, handled ina logical or physical 
mode, 
oO YCLOSS Closing of a standard or non-standard file, handled in a logical 
or physical mode 
YCLOUN Closing of a non~standard file, handled ina physical mode. 
YCLOUS Closing of a standard file handled in physical mode: 
YCKP9 Recovery checkpoint registration 


(ETOS ONLY) 


YGEFL Gets a logical record from a fixed length record file 
ro) YGETN Reads a block 
YGEV7 Gets a logical record from a file composed records with variable 


LL or less than 256 characters, 


YGEV9 Gets a logical record from a file composed of LL variable records, 
greater than or equal to 256 characters, 
YOPN Opens a standard file 


YOPNS Opens a non-standard file 


YPUFL 


Writes 2 logical record in a fixed length record file 
YPUTN Writ es a block consisting of a single record 


YPUV7 Writes a logical record in a variable length record file with 
records less than 256 characters 


YPUVS 


Writes a logical record in a variable length record file with 
records greater than or equal to 256 characters 


YREL Releases the block being processed and passage to the next one 
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EIOS_TAPE (Only EDOS) 


DESCRIPTION 


YCLCSN 
YCLCSS 
YCLCUN 
YCLCUS 
YCREL 
YGEFLC 
YGETNC 
YGEV7C 
YGEVSC 
YOPNC 
YOPNSC 
YPUFLC 
YPUTNC 
YPUV7C 
YPUVSC 
YSPA 


As for YCLOSN for concurrent program 
As for YCLOSS for concurrent program 
As for YCLOUN for concurrent program 
As for YCLOUS for concurrent program 
As for YREL for concurrent program 

As for YGEFL for concurrent program 
As for YGETN for concurrent program 
As for YGEV? for concurrent program 
As for YGEV9 for concurrent program 


As for YOPN for concurrent program 


As for YOPNS for concurrent program 


As for YPUFL for concurrent program 


As for YPUTN for concurrent program 


As for YPUV7 for concurrent program 


As for YPUV9 for concurrent program 


Service area for the concurrent tape routines and for 
arithmetic operations of the main and concurrent 


Tad 0509 71 
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Corrections 


YCLOSS 


- It did not handle correctly the closing of the. non-standard 
files by closing them erroneously as if they were standard. 
(F.R. 710547). 
When the WORK AREA was defined through a register it was not 
possible to record EOV at the end of the tape of a multivolume 
oO file. (F.R. 302008). 


YCLOUS 

- It did not handle correctly the closing of the. non-standard 
files by closing them erroneously as if they were standard. 
(F.R. 710547). 

+) YGEFL/YGETN/YGEV7/YGEV9 

- It accepted as TM any noisy monocharacter both 7 and 9 tracks 
for G.M.F. 

YOPN 


- If the cancellation date is equal to the one mentioned in 
cw] FILE TABLE, there was a HLT 01 FO. (F.R. 228306). 


YCLCSS/YCLCUS 


- It did not handle correctly the closing of the non-standard 
files by closing them erroneously as if they were standard. 
(F.R. 730547). 
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EIOS DISC 


°o 


DESCRIPTION 


Transcribes the index cylinders of a file on a proper index 
file present on the basic dise 


YDCK Writes a recovery point on a file defined in the volume 
containing the program file 


YFNDI Searches for the key in a mixed access file with UN records 

YFND2 Searches for the key in a mixed access file with FL or VL 
[+] records 

YFND3 Checks the presence of a record in a mixed access file 


with UN records 


YFND4 Checks the presence of a record in a mixed access file 
with FL or VL records 


YGETL Reads a UN record from a random or sequential file with 
random access 


Reads an FL or VL record from a random or sequential 
file with random access 


Reads a UN record from the page in a file with organization 
and random access 


Reads a FL record from the page in a file with organization 
and random access 


Reads a VL record from the track (or all the cylinder) in’a 
file with organization and random access 


YGET6 Reads a FL record from the track (or all the cylinder) in a 
file with organization and random access 
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DESCRIPTION 


Reads a page with UN records from a sequential 
or random file with mixed or sequential access 


YGETS Gets 3 FL or VL record from pages on disc, from 
sequential or random file with sequential or mixed 
access 

YGETA Reads a UN record from the track in a file with 
sequential organization and random access 

YGETB Reads a FL record from the track in a file with 
sequential organization and random access 

YGETD Reads a VL record from the track in a file with 
sequential organization and random access 

YINDX Furnishes, for files with index, the volume number 


and the track address for executing a GET 


Opens a file on disc 


Registers a UN record in a file with organization and 
random access, declared in updating 


Registers FL record in a file with organization and 
random access, declared in updating 


Writes pages with UN records. in a file with organiza- 
tion and sequential access 


Writes pages with FL or VL records in a file 
with organization and sequential access 


Inserts a record into the overflow zone in a file 
on dise with UN record, with sequential or mixed 
access, sequential organization, declared in updating. 
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DESCRIPTION 


Inserts a record into the overflow zone in'a sgequen- 
tial organization file with sequential or mixed access 
declared in updating 


YPUT? Inserts a UN record into the overflow zone.in a 
sequential organization file with random access 
declared in updating 

YPUT8 Inserts @ FL or VL record into the overflow zone 
in’a sequential organization file with random access 
declared in updating 

YPUXL Updates a page on disc with UN record with random 
organization and access 

YPUXK2 Updates a page on disc with FL record, with random 
organization and access 

YPUX3 Updates a page on dise with UN record, sequential 


or random organization and sequential or mixed access 


Updates a page on dise with FL or VL record, 
random or sequential organization, and sequential 
or mixed access 


Updates a page on disc with UN record, with sequen- 
tial organization and random access 


Updates a page on dise with FL or VL record, 
sequential organization and random access 


Positions the read and write heads on any designated 
track of the dise unit 


Positions the read and write heads on any designated 
track of the disc unit according to the key 


Mad, 0502/1 
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EIOS_DISC 


DESCRIPTION 


Executes the OPEN for concurrent program 

As for YDCK for concurrent program 

As for YINDX for DSU 157 

Executes volume change for concurrent program 


As for YOPCL with sequential file and access for 
© concurrent program 


As for YOPCL with sequential or random files and 
mixed or random access 


NOTE 


YGETB/YGETD OF/NZ=11 


If there is no overflow over the address in DA, the record 
having the greatest key is given to WA, in case of overflow 
there are two possibilities: 


1) if the requested key is greater than the last chained 
record in overflow, but smaller than the related record 
in the main area, the record given to WA is the overflow 
one and DA gives the address of the record resident in 
BA; 


the record with greater key comes from overflow and is 
oO given to WA; the address is given in DA. 


Tod, 0502 71 
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EIOS CARD READER/PRINTER (ETOS/EDOS) 


° 


DESCRIPTION 
YGETC Reads a card 
YOPENC Opens and checks a card file and reads the first 
card of that file 
YPUTPR Prints a line, moves the paper or closes the 
file on printer 
° YRELC Terminates the reading of a card before beginning 


to execute a checkpoint 


‘The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS. 


EIOS CARD READER/PRINTER (Only EDOS) 


DESCRIPTION 


YGETCC As for YGETC for concurrent program 


YOPNCC As for YOPENC for concurrent program 
YPUTPC As for YPUTPR for concurrent program 
(+) YRELCC As for YRELC for concurrent program 


od, 0507 71 
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Corrections 


YPUTPC 


In the case pf printer error, the subroutine jumped to memory 
address zero when in the printing FILE parameter EO was not 
expressed (F.R. 330201). 
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CARD READER 


NAME DESCRIPTION 


Reads cards with H code using CRZi00, CRZi11, CRZ120 


Reads cards in binary mode or mixed from CRZ100 or 
CRZ120 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS, 


CARD READER 
Corrections 


°o YCRZ2 


After binary reading it did not set the card read i 
reading. (F.R. 230337). oP yesperue. 


The text for binary or normal mode was not correct (F.R. 330197). 


oe 


Wad, O02 | 
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CARD PUNCH 


DESCRIPTION 


Punches H code ecards on CRP101 or CPZ103 


YCPZ@L 


YCPZ2 Punches H code cards on CPZ101 with recovery 
YCPZ3 Punches H code cards on CPZ103 with recovery 
YCP ZA Punches binary code cards on CPZL01 or CPZ103 
YCPZ5 Punches binary code cards on CP 2101 with recovery 
YCP26 Punches binary code cards on CPZ103 with recovery 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS. 


Limitations 
YePz2 ~ YCPZ3 
Reset does not work in Bull code for punching error (F.R. 710621) 


For YCPZ2 the limitations is valid for both EDOS and ETOS. 
For YCPZ3 the limitation is valid for ETOS environment only. 


Corrections 
YCPZ1~-6 


The connection number of the card punch was not taken from 
position 103. (F.R. 248522/338242). 


wad. asa fT 
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CARD READER - PUNCH 


t+) YCRP Punches with a card/reader punch that is used as a reader 
YCRPL Read and punch on CRP100 
YCRP2 Reads and puncher the same card using a CRP100 
YCRP3 Reads and puncher the same card and/or puncher a new card 
with CRP100 
YCRP4 Reads cards with CRP100 
° YCRP5 Reads and/or purcher cards in binary mode using a CRPLOO 
YCRP6 Reads and puncher the same card in binary mode using a CRP100 | 
YCRP7 Reads and puncher the same card and/or puncher a new card 
in binary mode using a CRPLOO 
YCRP8 Reads cards in binary mode with a CRP100 


The above subroutines are now available in two versions and function respectively 
only under ETOS or only under EDOS, 


CARD READER PUNCH 


Corrections 


YCRP1-8 


The connection number of the card punch was not taken from 
position 103 (F.R. 248522). 


Erse ee 


ETOS/EDOS 
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PRINTER _5/rs 


DESCRIPTION 


Paper movement command, or paper movement and 
print-a-line command on a PRT100 and 110 


(*) YPRT2 Paper movement command,or paper movement and 
pridt-a-line command on a PRT120 and 130 1 
(*) YPRTS Paper movement command, or paper movement and 
re] print-a-line command on a PRT118 
YPRT4 Paper movement command, or paper movement and 
print-a-line command on a PRT105 
(*) YPRT5 Paper movement command, or paper movement and 


print-a-line command on a PRT 143 and 146 
Read and print using a PRT140 - 160 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS. 


‘Med. 0802 71 
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PAPER TAPE 


DESCRIPTION 


Punches paper tape with 5, 6 or 8 tracks and with VL 


blocks 
(*) YPTRL Reads paper tape with 5, 7 or 8 tracks and FL blocks 
(*) YPTR2 Reads paper tape with 5, 7 or 8 tracks and VL blocks 
i) YPTR3 Reads paper tape with 5, 7 or 8 tracks and FL blocks 
recognizing and handling "upper cage" and "lower cage" 
characters 
(*) YPTR4 Reads paper tape with 5, 7 or 8 tracks and VL blocks 


recognizing and handling "upper and lower case" characters, | 
YPTRS Reads 6 track paper tape with VL blocks 


YPTR6 Reads 6 track paper tape with VL blocks and inverts the 
data field 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS. 


PAPER TAPE 


Corrections 


YPTR4 


The subroutine has been corrected since there was an error when 
handling Upper/Lower Case (F.R. 236393). 


Med, 0502 PT 
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ARITHMETIC 


NAME DESCRIPTION 


YYADS Algebraic addition of two fields 

YYDIVS Division .of two fields 

YYEX Unpacking the result of an operation 

YYLOAD Packing datas for executing the operation 
oO YYMULS Multiplication of two fields 


Subtraction of two operands 


The above aubroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS. 


The remainder of the division is found at address YYDIVS+54 (firat 
character to the left) for a length of 8 characters, packed and signed. 
Keep in mind that the remainder is found inside the subroutine and, there- 
fore, it is necessary to be careful how it is used. 
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DESCRIPTION 


YBIDEC Conversion of binary to decimal 

YCINLC Calculation of CIN beginning from the left 

YCINRC Calculation of CIN beginning from the right 

YDATDS Convertion of GGMMAA (day, month, year) to 
C+) AAGGG (year, day of the year) 

YDEBIN Conversion of decimal to binary 

YDSDAT Conversion of AAGGG (year, day of the year) to 


GGMMAA (day, month, year) 


YDSTER Conversion of Pence to L.s, d. 
re) YNUMCK Search for the numeric values in a field 
YPAYDT Calculation of data of payment 


Substitution of a character in a field 


YREPCH 
YSTERD 
*YCLK 


Conversion of L,s.d, to Pence 
Handling of the sub-system TDC100 


**YDUMMY Function of path tracing and printing of part of the memory 
(only EDOS) 
YCTWYY Handling of the I/O operation and paper movement 
(only EDOS) with CTW 
YBINVL Convertion into unpacked binary of the record length 


expressed in binary 


YVLBIN Convertion to binary of the record length expressed 
in unpacked binary 


«The subroutine exists in versions working respectively only in ETOS and only in EDOS, 


**DUMMY: non working in doncurrent/alternative/coexistent program. 
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8/P BOS Inserted in ETOS-EDOS Environment 


Following is a list of the S/P BOS that have been inserted in the ETOS and 
EDOS operating systems, specifying the numbers of connections of the 

peripheral units in such S/P that mustbe eventually personalized by means 
of the order .SPC before they are used, 


PERIPHERAL | PERIPHERAL 
INSTRUCTION 


DESCRIPTION 


(®) Y2MVT Prints for 2 paper move- 
ments 


PRT 110 PERX'CO' 


(+) Y301B Punches cards in decimal 


and binary with recovery CPZ103 PERX'30" 


YBBPH Transcodifies from T code 
to internal code 


YBIND 
(only 


Converts binary to decimal 


Converts decimal to binary 


Standard division 


Transcodifies from inter- 
mediate code to internal 
code. Only for T coge. 


PERX'30" 


Document feed 


PERX'10' 


Control and zero-out 


YINEX Transcodifies from internal 
code to intermediate code 
for the punching of sign- 
numbers in T code. 


Todo J 
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NAME DESCRIPTION PERIPHERAL| PERIPHERAL | DEC. 
UNIT INSTRUCTION | COD. 


©) YLBSB Reads with BY-PASS 


and prints CRZA20 PERX'80' 128 
YLBST Reads cards and prints CR2Z100 PERX'S0' 128 
PRT110 PERX'CO! 192 


YLSBUY | Reads BULL cards and 


(3) prints CRZLOL PERX'80" 128 
YLSBU PRT110 PERX'CO! 192 
(*) YLFQV Reads variable length PRTLOL PERX'20' 032 


blocks from paper tape 
with square holes . 


(*) YLSBQ Reads paper tape with PRT110 PERX'20' 032 
square holes and prints PRT110 PERX'60" 196 
YMULN | Multiplication standard 
(*) YMZAB Prints on PRT120 PRT120 PERX'10' 016 
PRT130 PERX'10! 016 
(*)  YP85 Punches cards CPZ101 - PERX'30" 048 
YpBasy| Punches cards in decimal 
ea and binary with recovery CPZzLoL PERX'30' 048 
G3) YPs5B Punches cards in decimal ; 
and binary with recovery cPAaa PERX'30' 048 
YPBDA Punches on paper tape with 
round and square holes PRT101 PERX'20' 032 
(*) YRB Reads carda with BY-PASS 
YRLDL Reads magnetic documents MDRi10 PERX'00' 000 
YRMD Reads documents MRS101 


103 PERX'10" OLé 


Mod, 0502 /1 
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NAME DESCRIPTION PERIPHERAL | PERIPHERAL 
UNIT INSTRUCTION 
(+) YRNSH Reads paper tape with PRT1O1 PERX'20' 032 
(+) square holes and norma- 
lizes the fields 
YRWPB General routine CRP with CRPLOO PERX'30' 048 
: BY-PASS 
YSCRL Changes character 1 
YSCR2 Changes character 2 
re) YSMD Selection in 10 stackers MPS 101 PERX'10' O16 
103 
YTC7 Transcoding! 
YTC10 Trans-positions 
Controller 10 
YTC11 Trans-positions 
e) Controller 11 
YTC12 Trans-positions 
Controller 12 
YTDBI Transcodifies binary num- 
bers from 6 to 8 bits 
YWDLD Reads magnetic documents MDR100 PERX'00' 000 
and prints PRT 110 PERX'CO' 192 
{*) YWRRP Reads and punches CRP100 PERX'40' 064 
* The above subroutines are now available in two versions and function respec- 


° tively only under ETOS or only under EDOS, 


Med, uae fT 
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Limitations 
YP85B 


It does not work during restart phase and the final call will be 
as follows: SWB Y85B + 388 (F.R. 334218). 


Corrections 
YT¢ 11 


Comparison was not made when the result was greater than 11 
{F.R. 222250). 


YRNSH 


The absence of x/COL 73 in cards 0210-0287, prevented PER 
personalization from UDMS (F.R. 212137). 
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S/P_TOS Inserted in ETOS and EDOS Environment 


Following is a list of tho TOS subroutines that have been inserted in the 
ETOS and EDOS operating systems, specifying the number of peripheral 

unit connections expressed in 5/P, that must be personalized by means of 
the .SPC order before being used. 


DESCRIPTION PERIPHERAL | PERIPHERAL DEC, 


UNIT . INSTRUCTION cop. 
(+) YBKRD Backroading of blocks in 
® magnetic tape file 
(*) YPLOL Punch cards CPZ10L Autopersonaliza. 
(+) YP103 Punch cards CRP100 Autopersonaliza, 


° 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS, 
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S$/P_RTRP in ETOS and EDOS Environment 


Following is a list of RTRP subroutines that have been inserted in the operating 


systems, 


DESCRIPTION 


Transmit (Group 1) 
Receive (Group 1) 
Read Card/transmit 
(Group 1) 
Print-Punch/Receive 
(Group 2) 

Read Card/Transmit 
(Group 3) 
Print-Punch/receive 
(Group 8) 

Open for Y620 Routine 
Open for Y621 Routine 
Open for Y622 Routine 
Open for Y623 Routine 
Open for Y624 Routine 
Open for ¥625 Routine 
Automatic Control 
Compiler Input/Output 
Computer 

Decide Diagnostic 
Diagnostic 

Funetion 

GO TO Input/Output * 
Input/Output 

Special 

Print/Punch Function 
ASCII-GECD Table 
Control Punch 

Decide FC 

FCS Print 


Y716 
Y27 
Y718 
Y29 
¥720 
YT21 
Y¥722 
Y722P 
Y723 
Y124 
Y725VY 
Y726 
YT 
Y728 
Y730 
Y7040 
Y735 


@)YGTTYY 
‘Y621G 
yl 
ym - | 


for G=50 ~ G-100) 


DESCRIPTION 


Only Peripheral 
Print Seco 


Qe. SQC Input 
~ Wait Printer/punch 


Unpack 

BCD/Bin 

Card Reader (Integrated) 
Card Reader (CRP) 
OC/SQS Output 

Wait Card Reader 
GECD/ASCH Table It 
Blank-Print Area 
Recovery Card Punch 
Time Out 

Pack 

Open for Y704 Routine 
Compiles Sub Calt Address 
and Change the Number 
of Datanet 
UTILIZATION CTW 
Subroutine for connection 


(*)The subroutine exists now in two versions working respectively only in ETOS and only in EDO! 
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DESCRIPTION 


YOPMTE Opens a magnetic tape file recorded on MTE 107 - 109 


YGEMTE Reads records from magnetic tape recorded on MTE 107 - 
109 


YCLMTE Closes a magnetic tape file recorded on MTE 107 - 109 


The above subroutines are now available in two versions and function respec- 
tively only under ETOS or only under EDOS, 


Functioning in EDOS environment ia not certified’, (1.C. B32614) 


Med. 0502 Jt 
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NAME DESCRIPTION 


YRMDE Reads a document 
YFMDE Feeds a document 
YFNVE . Validates and normalizes 
YSMDE Selects stacker 

) YTC10E Verifies Mod. 10 trans~position 
YTC11E Verifies Mod. 11 trans-position 


Verifies Mod, 12 trans-position 
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IDS Subroutines 


DESCRIPTION 


YGNCHN Searches for the next Detail Definition of the Chain-Chain 


YGNCTL Searches for the next Control Definition 

(+) YGNDET Searches for the next Detail Definition of the Detail Chain 
YGNFLD Searches for the next Field Definition of the Field Chain 
YGNNST Searches for the next Master Definition of the Master Chain 
YGNRCD Searches for the next Record Definition of the Record-Type 

Chain 

YQWRPG Writes a page on dise resetting first the Must Write 

+) Switch 


YQOSMWS Turns ON the Must Write Switch 
YQUCCB 
YQUDCH Updates the Reference Codes during the search of a record 


Updates the Communication Control Block 


Packs the page when a record has been physically cancelled 


YQADIU 


YZCHNT Zeroes-out the chain table of the M.D., R.D., and C.C.B. 
YQCLSE 
YQOPEN 
YQBIC 


Close of IDS file 


OPEN of IDS file 


Searches for the page in which the record searched for is 
found and furnishes it to memory 


YQMRAC Searches for a record in memory 
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DESCRIPTION 


° 


Calculates the reference code of the record using the 
contents of the randomization fields 


YQCALC 


YQTYPX Checks that the record found belongs to the object chain 


YQUPDC Updates the Record Definition and all the Master Defini- 
tions in which the record found appears as a detail 


YQRUND Updates the Reference Code of the M.D, prior record 
YQMNO Registers a new record on the page 
°o YQMOVE Moves the record from memory Buffer to Working 


Storage and vice versa 


YQGETD Searches for the record by means of Direct-Reference 
when the verb "RETRIEVE DIRECT" is used 
YQGETE Furnishes the records that are found between the 
FIRST-REFERENCE and LAST-REFERENCE when 
*] the verb "RETRIEVE EACH" is used 


YQHEAD 
YQMOV 


Furnishes the Master Record of the specified chain 


Sets the parameters for transferring the record from 
memory Buffer to Working Storage 


YQDLNK Disconnects logically the current record from the chain 
from which it has been removed 


YQDLTE Cancels the current record 


YQSAC 


. Compiles the addresses of some subroutines for the 
modified calls 


Like YQSAC 


Searches for the Next, Prior, Master or Current record 
of the chain specified in the verb "RETRIEVE" 


YQSACL 
YQFWD 
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SYSTEM | } PROGRAM 


DESC RIPTION 


Finds again the record comparing the contents of the 
control chain initialized in w.S.S. with those of the 
record in the memory buffer 


YQGDET 


YQASC Searches for the record by meana of the contents of the 
field, Field-name, of the clause "RETRIEVAL VIA 
field~name FIELD" 

YQREMV Physically disconnects the current record of the 
specified type from the specified chain of the verb 
"REMOVE" 

YQLNK Ingerts logically (connects) the record in the specified 
chain 

YQISRT Prepares the necessary conditions for logical insert 

YQMDFY Modifies the fields of the record as requested by the 


verb "MODIFY" 


YQCHN Prepares the necessary conditions for the re-finding 


of the record through its chain of be longing. 


Prepares the conditions necessary for the re-filing of 
the record by means of the FIELD name 


YQGET 


YQSTOR Registers the record physically 


YQGETC Searches for the current record by means of its 
reference-code when the phrase "RETRIEVE CURRENT" 


is used 


YQOPNX Subroutine that opens the IDS file bypassing some checks. 
It is not usable by the user, but is reserved to the 


compiler of the IDS software, 
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NAME DESCRIPTION 


YIDS It accomplishes check functions contains all the common 
constants, a series of error messages and references to 
all the subroutines of the package for the assembly in 


° memory. 


YQJREG Data block writing 
YQIPRE Data block preparation 
YQWPG Check on pages to be written 
YQJOP Opening of the movements file tape 

fe) YQREST Used to recover the IDS pages on disc 
YQTAB Preparation in memoryof the check table 
YCKP Writes the recovery points. 


NOTE: The subroutines must be allocated in the subroutine file according to 
the sequence given in the lst, 


Corrections 
_YQOPEN 


If fiels with INDEX SEQUENTIAL were used in IDS, FA might got 
destroyed when reading the file. (F.R. 330192). 
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COBOL Subroutines 


DESCRIPTION 


YADSU - Addition and subtraction 


YALFAB Checks if a field is alphabetical 

YALL For function ALL 

YALSEC Segment feed 

YBDC Conversion binary/decimal 

YCC1 Comparison between whole operands and in display form 

YCCLE Comparison EQUAL between operands of the type defined 
DISPLAY 

YCC1G Comparison GREATER between operands of the type 


defined DISPLAY 


YCc1LL Comparison LESS between operands of the type defined 
DISPLAY 


YCCINE Comparison NOT EQUAL between operands of the type 
defined DISPLAY 


Comparison NOT GREATER between operands of the type 
defined DISPLAY : 


YCCLNG 


YCCINL 


Comparison NOT LESS between operands of the type 
defined DISPLAY 


Close for card files 


YCLCR 


YCLOPR Close, for files on printer, 

YCOLON Aligns. — .operands for arithmetic operation 

YCONCC Executes all the various types of comparison for 
unpacked and ligned operands 

YCONE Comparison EQUAL between operations like S/P YNUM 


YCONG Comparison GREATER 
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DESCRIPTION 


are 


YCONL 
YCONNE 


Comparison LESS 


Comparison NOT EQUAL 


YCONNG . Comparison NOT GREATER 
YCONNL Comparison NOT LESS t i 
YCOPN Open’ for tape files 
YDBC Converts decimal/binary 
YDP130 Display 
o YEDT Data edition 
YEV130 End of volume 
YEXAMI For examine 
YGECR Reads cards; it is automatically called from YREACR 
yGgo1 For GO TO DEPENDING ON in the case of segmentation 


and/or in the cage in which the variable that pilots 
the GO TO has been declared COMPUTATIONAL=1 


Comparison between 2 signed and numerical operands 
whose length is more than 16 characters 


Calculates the principle address of the matrix 


Multiplication and division 


Transfer of fields having length of more than 256 
characters 


Multiplication and division is called only in the case of 
operands of a length of 16 characters; in the case of 
operands of an inferior length (1-15 characters) the 
YMDL30 is called 


Checks if the field is not alphabetic 


YNALFA 
YNNUM 
YNUM 


Checks that an unsigned field is not numerical 


Checks if an unsigned field is numerical 
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DESCRIPTION 


YOPECR Open for files on cards 

YOPEPR Open for files on printer 

YBERFC © RE-entry from a PERFORM in the case of segmented 
program 

YRANGO Preparation of a re-entry address from a PERFORM 

YREACR Cards reading 

YRISU Prepares the result of an arithmetic operation 

YRW130 Report writer for 130 

YSALTC Handles paper movement: it is called automatically 
by YPUPR 

YSNNUM Checks whether a marked field is not numeric 

YSNUM Checks whether a marked field is numeric 

YTAI Aligns two operands before executing the comparison 

YWITPR Print 

YDPCTW Printout on CTW (only EDOS) 


Note: Subroutine YCOPN has now two distinct versions - one for 
ETOS and one for EDOS respectively. 


Corrections 

YEV130 

It recorded the label EOF when HLT O1F6 occurred (F.R. 309055). 
y@gor 


The subroutine used the print line without performing a validation 
beforehand (F.R. 302001/312083). 
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§/P- FORTRAN 


DESCRIPTION 
° YFSIN Calculation of sine and cosine 
YFEXP Calcutation of exponent on base "E" 
YFFEX Exponential function between real numbers 
YFTANH Hyperbolic tangent 
YGIO Input Output 
YGIOL Input Output 
‘YGIO2 Input Output 
YERROR Errors Print 
°o YSEGMT Segmentation 
YFSIGN Moving sign between real numbers 
YFABS Module of real numbers 
YINTAB Module of integer numbers 
YSNSSW Switches condition test 
YREAL Transformation from integer into real numbers 
YINTSG Moving sign between integer numbers 
oO YCMPGO Calculated "GO TO" 
YIADD Addition between integer numbers 
YFMUL Multiplication between real numbers 
YFDIV Division between real numbers 
YFADD Addition between real numbers 
YFSQRT Square root function 
YINTEG Transformation from real into integer 
YIMUL ‘. Multiplication between integer numbers 
YIDIV Division between integer numbers 
YSNAP Memory Dump 
YARRAY Calculation 
YFSBT Subtraction between real numbers 
YIEX Exponential function between integer numbers 
YFIEX Exponential function between real and integer numbers 
° YISBT Subtraction between integer number 
YFATAN Arctangent 
YFALOG Logarithm 
YBIND Conversation from binary into decimal 


YDECB Conversion from decimal into binary 


Mod, 0502/1 
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RPG SUBROUTINES 


Tn addition to the standard subroutines of the EIOS, BIOS, etc., the RPG uses 
the following subroutines: 


DESCRIPTION 


_ TABLE LOOK ~ UP - LINEAR SEARCH 
TABLE LOOK - UP! - BINARY SEARCH 
DIVISION 
MULTIPLICATION 
ADDITION/SUBTRACTION 
TEST OF ZONE ON A SINGLE CHARACTER 


Mod. oer Jt 
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SOGET 0 Subroutines 


DESCRIPTION 


YCOMMN Handles the receive in transmit procedure for POLLING 
aud SELECTING only ICO terminals 


YCOMMB Handles the receive-transmit procedure for POLLING 
and SELECTING only BURROUGHS terminals 


YREADL POLLING of all terminals 

YREAD2 POLUING of a terminal 

YWRITEL SELECTING of a terminal 

YWRTRD POLLING and SELECTING of the same terminal 

YWORD SELECTING or POLLING of the same terminal 

YRDWB1 POLLING of all terminals with "INTERRUPT" procedure 
YRDWB2 POLLING of a terminal with "INTERRUPT" procedure 
YWRWB1 SELECTING a terminal with "INTERRUPT" procedure 


YRDWT Utility subroutine for POLLING and SELECTING procedure 
of a certain terminal 


YINTR Re-entry for "INTERRUPT" procedure 

YAWAIT Waits for the end of a procedure 

YCCIE Compiles instructions for the procedure of "INTERRUPT" 
YRRE Resets instructions relative to the "INTERRUPT" 
YRTRN1 Performs the re-entry in the user program 

YDIAGL Prints diagnostic messages 


Takes out the terminals from the POLLING TABLE 


YDELT 
YINST Subroutine for inserting a Terminal in the POLLING TABLE 


YCOMP Compiles the instructions relative to the peripheral 


Initialization subroutine 


YOPNSG 


Twos, 0502 Ft 


Honeywell ATTACHMENT TO STL wet] 0] 215) or FW. | | rage 


Honeywell information Systems Halla 


vom LY Cog ng] 


DESCRIPTION 


YDDIAG - Disables the execution of the subroutine YDIAG1 
YEDIAG Enables the execution of the subroutine YDIAG1 


YINP1LY Executes the transcodification table in INPUT for 
terminals ICO TC100 


YOUTLY Executes the transcodification table in OUTPUT for 
terminals ICO TC100 


YINP2Y Executes the transcodification table in INPUT for 
BURROUGHS terminals 


YOUT2Y Executes the transcodification table in OUTPUT for 
BURROUGHS terminals 


med om Ft 
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BDTR_ Subroutines 


° 


- Visible to the user (the complete file is found on Page #108) 


NAME DESCRIPTION 


YADVE 


Prints message on teletypewriter for operator 


YBRCH Identifies message 
YCALS Calls the STATION (TTY) 
YDSBL Disables the line 
YEMTYR Empties the PAGE AREA 
YENBL Enables the line 
° YENDR End of RECOVERY PROCEDURE 
YENDW End of application 
YESQS Launches recursive part 
YFREE Frees the STATION from the dialogue 
re) YLORA Assigns recursive procedure beginning addresses 
YPAUS Interrupts the dialogue : 
YRDAR Reads anomalous message 
YRDRAP Reads message 
YRQST Requires statistics 
YRSTO Re-admits to the dialogue a STATION excluded with the YPAUS 
YSETS Establishes the time a segment must stay in memory 
YSETT Establishes the POLLING time of a STATION 
YSPOL Starts ENQUIRY 
YSTOP Ends the application for a STATION 
oO YSUBS Replaces 2 STATION with another one 
YUPDU Loads USER ZONE contents 
YWAIT Waits for the end of reading with by-pass 


Identifies STATION (ITY) 


‘YWHOS 


Mod, 0009 | 
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DESCRIPTION 


Reads or writes 
Writes 

Reads and writes 
Writes with by-pass 


NOTE : 


Only the eventual variations to the subroutines are cited in this list. 


Limitations 


If the center is furnished with a clock for data transmission applica- 
tions, it is necessary to protect against the interrupts of this peripheral 
in one of 2 ways: 


1) Turn off the clock. 


2) Inhibit the interrupt either on the direct connector of the central unit 
if connected without MPA, or on the corresponding MPA connector, 
(.C, B32613) 
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Corrections 
YCASEG 
The subroutine has been modified in order to decrease loading 


time of a program segment, (F.R. 321145) 


XENBL/ YESQMB/YESQMNL/YFAT/ YMDMRI/ XMDMRO/ YOPENY/ YPROC/ XYSTAMP/ 
XYPROBA/YWHOS 


When calling a terminal in selecting, if an answer different 
from EOT or ACK was given, there was a bad functioning of BDTR 
and of the access on disc in particular, (F.R. 312073/312075/ 
325161). 
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VIP SUBROUTINES (Complete documentation is on page G 09) 


NAME DESCRIPTION 


YOPNY Initialize the system by setting all. the 
: parameters and tables at the initial status 


YPOLG Pelling of all the terminals initialised 
YPOLD Polling of one terminal only 
YSELEC Selecting of one terminal 


YDELET Logical exclusion of one terminal in the polling 
table 


YRESTO Logical insertion of one terminal, previously 
excluded or non initialized by YOPNY. 


YSPBSY Physical message receiving and sending (automati-| 
cally called by subroutines YPOLG-YPOLD- YSELEC 
YDELET-YRESTO). 
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SUBPROGRAMS USED IN EDOS FOR PARTICULAR HANDLINGS 


NAME DESCRIPTION 


YPTT Monofile print to tape conversion 

YPTTU- Multifile print to tape conversion 

YMSGP Handling of CTW in print to tape programs 

YMSGPC 0 ° “ a " 

YPROTE Protection of updating of more files by two 
programs in alternance/coexistence 

YTIMEO TIME/OUT handling in alternance/coexistence 

YWNBE Numbered blocks handling 
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. APS (EDOS) 


NOTES 


In the case in which a W.D. is not present, a three-cylinder free zone 
is requested on the S. D. 


- It is not possible to use more than 50 names in the FILE phrases with 
12 K memory. 


- It is not possible to continue random processing of a sequential file 
with index if for the last record of a volume the macrophrases DELETE 
and INSERT are given in that order. 


- The prints relative to CHECK POINT are always on printer if the 
re) program does not use EIOS (dise and tape). 


- The external file name is put initially equal to the internal, ina 
way that makes the BLBC card unnecessary. The use of this card remains 
obviously for all the other checks on it reported, 


- It is possible to re-call segment 1 from subsequent segmentsialso if 
the program contains "FILE", that is if segment 1 does not contain "FILE" 
for reader or printer 


SRC and .DSRC 


These orders can be launched using two discs at the only condition that 
the INPUT DISC is coincident with the BASIC DISC, 


Limitations 


It is not possible to check the .APS FILE as the check may only 
be executed by macros. (F.R. 329187). 


Corrections 


Card duplication with READ-CHECK at the end of the file. 
(F.R. 248516) 


od 0502 71 
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-APS (ETOS) 


NOTES 


- In the case of "NO LISTING", the errors I on the DC may not be 
°o printed; nevertheless the segment “INVALID TRANSLATION" appears. 


- The long comments must not have all spaces in Col. 18 - 25 
(extremes included); otherwise they are considered as phrases of 
BASIC APS, 


~- It is not possible to recail segment 1 from subsequent segmentes 
if the program contains "FILE". 


Corrections 


It assembled wrong characters if the subroutines were small 
than 20 characters (F.R. 327165/327144). a 
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SYSTEM [ ] PROGRAM [ ETOS/EDOS 


COBOL 
LIMITATIONS 
PERFORM 


REDEFINES 


LEVEL 77 


DATA RECORDS 


ARE 


SEEK WITH 
INDEX 
CONVERS TON 


- If a PERFORM recalls a section name, in the same 
section there must be at the most a single EXIT, and 
whenever this is present it must occupy the last 
position of the section. 

Whenever the above is not verified, there is an 
incorrect translation of the source without emission 
of an error message. 


A phrase of type ADD A GIVING G is not signalled hy 
the complor. The generated code is feasible and the 
result of the operation is the transfer of A to C. 
If in a program an ADD is erroneously written with 
more than 9 operands, this error is not detected 
and compilation cycles. (F.R. 241432). 


A check does not exist regarding the correct lenghts 
of the re-defined field with respect to the one that 
defines it. (FR. 690435, 690466), 


If level 77 is written begiming from Col. 7, the 
translation is incorrect (it's translated as level 
7) and there is no error signal, 


A check does not exist hetween the names of the 
listed records in a F.D. and the corresponding 
descriptions. (F.R. 690436). 


«= The formal control requires the work WITH in the 
instruction SEEK file name WITH INDEX CONVERSION 
(mandatory). 

An erroneous spelling of the verb type SEEK:SEEK file 
name INDEX KEY CONVERSION is not detected by the 
compiler and the translation is not correct (710454). 


The use of the index for a field not defined with 
OCCURS is not signalled (F.R. 690540). 


Data defined with OCCURS and used in procedure with- 
out index are not detected and signalled by the 
compiler, and the address of the first element is 
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There are no error signals about the incorrect writing of the 
STOP. In particular, if the constant that follows the STOP 
is not written between commas, the STOP is translated with 
a HLT at 0000; if the constant is omitted in addition to 

being translated to a STOP with 1 or more HLT's, the 
translation of the instruction that follows the same STOP 

ig lost, If the Literal has a length of less than 4 characters, 
the compiler assigns an incorrect address. (690389) 


If the verb STOP is not followed by a constant, for example 
STOP, the reference to the line is not correct. (690388) 


GOTO If the procedure name to which the GO TO jumps is formally 
incorrect, it can give inconveniences in the compilation 
phase without error signals. (F.R. 690499) 


IF - The IMPERATIVE STATEMENTS that follows the condition 
IF must be followed by a full stop. If the full stop is 
missing, no error messages will be given but the com- 
Pilation may be wrong, (F.R. 700256) 


- If in the true part of an IF there are conditional phrases, 
the translation will be incorrect. (F.R, 690425) 
(F.R. 690578) 


- fin an IF, the word ELSE is preceded by a full stop, 
no error signals are given but the translation will 
result incorrect, 


In the case of composed conditions, if an AND is followed 
by an OR, the translation will be incorrect, (F,R. 700305) 


- Ifa file is used on reader,the card reading will be accom- 
plished in the resident segment. (F.R. 710636) 


- Ifa wrong writing occurs of the IF verb of the type: 
IF name-relation-name ADD A TOB 
* name-relation-name ADD C TOD 


in which in correspondence of the character "*" there is 
not the closing point of the first phrase and the [F verb for 
the second phrase, the compilation stops. (F.R. 203015) 


- The following result: 

IF POSITIVE, IF NOT NEGATIVE or 

IF NEGATIVE, IF NOT POSITIVE 

is not the same if the field contains character 0 
0 R. 227296). 
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PICTURE - If a numeric field is pecified with an alphanumeric 
PICTURE, no error signal is given (F.R. 700281). 


If the option VALUE is used at a high level, the 
error signal is not detected. 


If a wrong description as: 
02 Data-name PICTURE X (0) 


is given, the compiler will not detect the error 
and the translation will be correct as long as the 
Data~name is not referenced ina Procedure. If 
instead such a Data-name is referenced in the 
Procedure, the compiler stops printing the message: 


COMP ERR. 
(F.R. 710517) 


In some particular cases where data is defined with 
PICTURE containing the character "V" and the option 
VALUE, the calculation of the length is correct but 
the corresponding on the object listing can be 
different from the length calculated. This does not 
compromise execution (F.R. 213158). 


FILES WITH In case of files with index, the compiler does not 
INDEX control that the number of characters forming the 
page, is at least equal to a sector. This control 
is made by the user because there might be, as a 
consequence, INVALID ADDRESS in execution. 
(F.R. 243465/309009), 


DISPLAY 


When printing several constants, if the caracter " 
(quotations) is erroneously written there will be 
a wrong generation of the object program without 
error signal (F.R. 303013). 
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FORMAL CHECK Some serious formal errors cause the printing of 
proper messages plus several pages of non existing| 
messages, 


ENTER APS If in an ENTER APS instruction an operand is 
indicated as symbolic name with adjustment and 
the value of such an adjustment is lacking 
(e.g.: MVC NAME + (125),NAME 1), no error signal 
is given and the translation will be incorrect 

(F.R. 700372). 


When using large segmented programs, if the 
operand of an instruction "MOVE" is not defined, 
no, error signal is given. A MOVE instruction, as, 
for example: MOVE C2 TO C1 where C2 = 00.04 and 
€1 is defined PICTURE 22,22, the result will be 
-B4 instead of .04. 

- The transfer of a filed defined as "X" to 
another one defined as "Z" is not a correct 
mode of operation. This is not detected by the 
compiler and a wrong generation of the object 
code is made (F.R. 710378-710413). 

- An instruction of the type: "MOVE SPACES TO A", 

in which field A has a length exceeding the 

8000 (eight thousand) characters is not 

translated and the message comes out: COMPILER 

ERROR = INTERMEDIATE CODE INCORRECT. To solve 

such an inconvenience it is advisable to divide 

field A in two subfields and to accomplish two 

distinct MOVE's, (F.R. 211126). 


In an instruction of the type; 


MOVE A TO BC ....D. 


if the amount of the lengths of the receiving 

fields is greater than 8000 (eight thousand) crts. 

the compiler may behave as follows: 

1) exit of message "COMPILER ERROR INTERMEDIATE 
CODE INCORRECT" 

2) the program goes into loop 

3) there might be a cancellation of the SD, 


In 
more MOVE's with operands whose amount of lengths 


order to overcome this it is advisable to make 
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is smaller than 8000 characters (F.R. 211126 - 
313092). 


If an alphanumeric value (VALUE) is given to a 
numeric datum, no error message is reported, 
(FR. 700164). 

If an alphanumeric constant is not between 
quotation marks it is accepted. 


GO TO DEPENDING If this instruction is not followed by a period, 
the following verb is disregarded. 


The verb USE in the following format: "USE AFTER 
ERROR PROCEDURE ON INPUT-OUTPUT", cannot be used. 
The alternative is to use it the following format: 
“USE AFTER PROCEDURE ON file-name" repeated the 
number of times of the files defined on tape. 

The compiler will not be modified and this 
restriction will be reported in the updated 
documentation. 


PERIOD" ," If a COBOL source statement ends with a period 

in col. 72 character (,") in Col, 72 and the program's 
identification is contained in Cols. 73-80, the 
translation will not be correct and an invalid 
message is printed (F.R. 710463). 


SUBROUTINE If a special subroutine (Y....¥).is assembled in 
a non-resident segment there will be a wrong 
allocation of the subroutine itself in the memory. 
(F.R. 228307). 

This limitation will be eliminated in ET026. 
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REPORT - In particular cases the PAGE-COUNTER printout 
SECTION is not correct. (F. R. 210111/207073/211132/224271/230334 ) 


In the case that a DE line with the NEXT GROUP 
PLUS 1 option is printed on the last detail line and 
the successive DE line would have the NEXT GROUP 
NEXT PAGE option, it jumps continuously to the 
next page and prints only a heading. (710591) 


DM - Using the DM option, it is possible to get the message 
"837 RECORD IS NOT ALLOWED", relative toa 
certain file, also if the options are defined correctly. 
This is because WRITE was not specified on that 
file, (F. R. 710687) 


(e] ELSE - I£ a COBOL phrase begins with ELSE; no error 
message is printed and the generated code is 
wrong. 

SUBTRACT - The format of the instruction "SUBTRACT" is 


not checked if it is correct. If ''FROM' is spelled 
"GROM" the compiler goes into a loop. 


LOOP_IN COMPILATION - If a type 01 level is not indicated (missing 
punch 1 or 0) the compilation goes into 
loop (F.R. 307044). 
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FREE CYLINDERS FOR 


COMPILATIONS IN EDos 


USER AREA 


NUMBER OF ERRORS 


FILES ON TAPE 


COBOL _ETOS KNOWN 
ERRORS 


To compile medium-large size programs 
(2000-2500 source cards) 8 cylinders per 
file are sufficient (24 cylinders in alt). 


In case of particular compilations where 
the source deck assumes enormous 
proportions (over 3000-3500 cards) it is 
advisable to bring the number of free 
cylinders on the SD to at least 15 and 
on the WO, which contains 2 files, to at 
least 30 free cylinders. 

If this limitation is not followed there 
may be an outgoing of the free area and 
cancellation of the following file. 
(F.R. 309065). 


The object program generated by the COBOL 
G 100 compiler uses the USER AREA if the 
REPORT SECTION has been defined. 

(F.R. 242438). 


In the case where the number of error 
encountered in a program is greater than 
360, the compiler halts at 1880; by pressing 
START the compilation continues (FR 690501). 


If a file is used on reader, the card 
reading will be accomplish in the resident 
segment (F.R. 710636). 


If a tape is not enough to contain the data 
of a file declared monovolume the tape will 
be processed until the end. It is advisable 
to use MULTIPLE REEL clause. (F.R. 251553). 


In order to be able to print the last card 
(END OF PROGRAM) the card feeding hopper 
must never reamin empty. 


If during the loading of a card file on tape 
the check point is required, once this is 
accomplished, the printer enters into a 
loop. 
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Corrections 


In some cases the PAGE-COUNTER did not work correctly 
{F.R. 710127/207073/200032/224271/230334/243458). | 


If characters EDITING CR/DB were present in the macros 
generated by verbs such as MOVE,ADD...., there was a jump 
instruction with a wrong address by 2 characters (F.R. 309058). 


Writing of verb "IF NAME NEGATIVE" generated, in particular 
case, wrong addresses for the constants. (F.R. 232374/305028/ 
309049/309054). 


A wrong translation used to be given if at the beginning of a 
group in the REPORT SECTION, only the clause LINE NUMBER was 
described at level 02 (F.R. 710268). 


In the case of unblocked record, if the optional clause 
BLOCK CONTAINS...., was not specified, a subroutine, inadequate 
to the type of file declared, was assembled. (F.R. 312085). 


In LINKAGE SECTION, the data defined C-2 with odd length 
were erroneously translated. (F.R. 330196). 


When transferring an alphanumeric data into another field 
defined as numeric with EDITING, the generated MACRO was 
correct (F.R. 238478/250546). 
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- If a subroutine called in ENTER APS started in a column different 
from 25 of the card the error was not detected (F.R. 324155). 


- If a subroutine ending with DS was called in an independent 
segment, there was a wrong generation of addresses 
(F.R. 3375114/334228/330290-. 


- If INDEX SEQUENTIAL files were used in COBOL/IDS, the FA was 
frequently destroyed with consequent error in the program 
execution (F.R.330192). 
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FORTRAN - 130 (ETOS/EDOS 
Diagnostic Limitation 


- No error is signalled if a numeric FORMAT writes non-numeric 
characters. This limitation will not be eliminated (F.R. 700134). 


NOTES 


DATA - Data occupation in memory must not exceed 32K for 
each P.U. 


cTW - It is possible to compile and load FORTRAN G 100 programs 
by using CTW only for operating system messages. 


Corrections 


°o There were inconveniences on the phrase EQUIVALENCE (F.R. 307043). 


In the case of personalized SD with CTW 16K memory, the 
compilation did not.end, that means the final message. was not 
printed. 
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Within EDOS the programs generated by the compiler work asi 


main/secondary in Spooling 
Current/Coexistent in Coexistence 
Current/Alternative in Alternance 


with the following limitations: 


- in case of Chaining option it is necessary that the last n. ( 
(k+6) memory position are not occupied by the program, where 


k = number of characters forming the key 
n = chaining number 


in case of table files defined in input it is necessary to 
define always a file on reader. 


only for concurrent/Coexistent/Alternative programs containing 
tables in input it is not possible to print them. 


in case of programs launched as COEX/ALT it is necessary that 
the respective programs are ended before passing the control 
to the main program. 


when the printer goes in "OFF" without passing through. "STAND 


BY" the OPERATOR CALL key stays lit; if the printer is reset the 
work continues but the last print line is not written correctly. 


Note 


When a field having a value of negative zero is edited, the 
character "-" appears in printout. 
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RPG (ETOS) Limitations 


It is not possible to use 7 track tape. 

In the case of RPG with double paper movement, subroutines 
YGETC, YPUTR are not printed after the last file but after 
the second print file. 


+) When the printer goes in "OFF" without passing through "STAND 


BY", there is a HLT at OOAO. Reset the printer, press key 
STRT and the compilation goes on. 


RPG _(ETOS/EDOS) Limitations 


When a field defined as alphanumeric is used in addition and 

oO subtraction operation, no signal is given; in muitiplication 
and division operation nothing is detected but the error 
signal is given by the APS translation (F.R. 219228). 


If a "FIELD RECORD RELATION" is associated to the contro] level 
fields, note n. 158 is given incorrectly. The good functioning 
of the program is not compromised (F.R. 244476). 
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2RPG Corrections (ETOS) 


~ There was a length and spelling error fn the message: 
xxxxx CONTROL CARD READ JOB TERMINATED x» (F.R. 305020) 


- There was a HLT because of a PER (F.R. 334217). 


«RPG Corrections (ETOS/ED0S) 


- Whe the printer went into POWER OFF iwthout passing through 
STAND BY, a HLT at OOA2 occurred (F.R. 248536/251555) 


When there was an unblocked type file, the parameter WA=RC 
appeared in the FILE generated by the compiler. 


When writing the source program, NOTE 229 was given incorrectly. 
(F.R. 321135). 


The load address is generated after the file GET with a variable 
Jength record but the address of the field is not shifted by 
@ characters. (F.R. 250543). 


«RPG Corrections (ED0S) 


- When the table file was defined in input from disc, all the 
codes were shifted on the right by one character; this because 
the first character of the record was considered as data field. 
(F.R. 312079). 


When writing the source program, NOTE 070 was printed, while in 
the note list it appeared as NOTE 170. 


It was not possible to work with CPU at 16K because there was 
a memory overflow in segment 40 (318121). 
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.SPG_ (ETOS) 


= With the exception of those cases shown on the manual, the entry 
to the auxiliary routines is not always done through register 6 
containing 43F0. aa 
Therefore the exit from a subroutine within the auxiliary one will not 
be through JU252 unless the user has previously set register 6 to 
hexadecimal 43F0. 


- In the case where a user routine provides, for the insertion of additional records 
at the end of file, the following message is-incorrectly printed: 


INPUT RECORD COUNT = nnnnu ; OUTPUT RECORD COUNT = 
monnn A SUMCHECK ON A KEY HAS FAILED 


The program halts; by pressing START all continues normally. 
The difference between the input record and the output record “ig 
given by the number of additional records of the user routine, 


LIMITATIONS 

- It is possible with the use of auxiliary routines at level 
NNS, to SORT with multi-reel tape if all the reels are 
closed by EOF and by following this procedure: 


a. On the DVC input card, assign AT = X where X is 
different from mT. 


b. Assign to MT and AT the effective values as on BLBC card 
which may be equal or different. 


Corrections 


With double paper movement printers there were inconveniences 
in paper skip. (F.R. 236399/302007). 


Since the checkpoint has been lengthened, it is necessary to 
widen the area relative to the same. 
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.SPG 
NOTES 


- The compilation halt 1111 signals the insufficiency of space on 
disc, or discs, used for compilation. 


In the case where an additional user routine provides to the 
insertion of additional records at the end of file, the 
following message is incorrectly printed: 


INPUT RECORD COUND = nnnnn; OUTPUT RECORD COUNT = nnnnn 
A SUM CHECK ON A KEY HAS FAILED 


The program halts; by pressing START all continues normally. 
The difference between the input records and the output records 
is given by the number of additional records of the user routine. 


If parameter MR is used in input, the output must be done on 
tape. 


The INPUT-OUTPUT blocking is used accwrding to the memory, the 
values stated below are considered indicative. 


8 BIT RECORDING MODE 6 BIT RECORDING MODE 


12K 
16K 
24K 
32K 


280 12K BS. = 384 
550 16K BS 768 
1440 24K BS 1920 
2880 32K BS 3840 


the record length is intended both as record-block and as 
record "RL" (Fixed length) submultiplg of BS. 


Since in 12 and 16 K environment, the possibilities are rather 
limited, it is advisable to use parameter SF = A or M contained 
in macrophrase FLD, page II/31 of SPG Manual; this parameter may 
be requested only when the files in input are from disc. 


A = only the disc addresses of the records ordered according 
to the records keys in input. 


M the disc addresses of the records accompanied by the sort 
keys, placed in order of importance (see macrophrases Key ~ 
Sort). 


The user will reconvert the addresses or the addresses + keys 
into actual records. 
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LIMITATIONS 


- It is possible with the use of auxiliary routines at level NNS, 
to SORT with multi-reel tpae if all the reeis are closed by 
EOF and by following this procedure: 


a. On’the DVC input card, assign AT = X where X is different 
° from MT. 


b. Assign to MT and AT the effective values as on /BLC card 
which may be equal or different. 


In the case of a system personalized with CTW memory exceeding 
the one declared in the STRT of the SPG program, the program 
functions only with the CTW on. 
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-5PG Corrections (EDOS) 


- The keytape did not function (F.R. 315106). 


The FE parameter did not function beyond a certain number of 
records. With records having a fixed jength smaller than 100 
characters there were rather high times during sorts. 

(F.R. 327166/318116). 


It generated a block in output for empty fil-s in input 
f+) (F.R. 321143). 


With a source program generated by .EXSP it did not consider 
the beginning address sector. (F.R, 322150). 


A sort "tag" of a file in which the records data reside in 
overflow zone, gave a wrong address at the first record of 
the overflow zone. (F.R. 329183/330202). 
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NOTES 


- The statement "SELECT IDS .NAME-FILE ASSIGN..." must be on a 
single card. 


Levels higher than 02 are not considered, therefore the user 

oe must specify at such level the real length of the data field 
keeping in mind the length reduction effected by the COBOL 
compiler in the case of fields with USACE COMPUTATIONAL-1 or 
COMPUTATIONAL-2. 


The VALUE is no permitted at level 02. 


To use a non-standard randomization formula (furnished by the 
user) is not easy, (a subroutine must be modified and the new 
°o formula must be coded in APS). 


The translator does not check card-sequence error, 


It is not possible to insert a detail in all the chains to which 

it belongs by using a single MODIDS verb, but it can be done by 

using as many INSERTS as the number of chains of the records to 
° which it belongs. 


LIMITATIONS 


~- When it is accomplished a RETRIEVE-NEXT or an HEAD for chain 
whose current record is a detail, but in which it has not bean 
inserted, the program, instead of aborting, cycles. (F.R. 205 058) 
(The limitation will not be removed). 


- The IDS owrd cannot be used to define in W.5, constants of the 
type: 


VALUE "ZIDSH" (such a limit will not be removed) 


°o - The translator does not signal the MODI 
(FoR. 338218), e FY error on level 01 
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Corrections 


° 


- It was not possible to use an INDEXED file when an IDS file 
is present. (F.R. 207080/330192). 


- It is now possible to use the IDS input even from disc in addition 
to the cards reader input. (F.R. 248520). 
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NOTE-ETOS/EDOS 


The absence of the function extension code causes the loss of the phrase 


- Programs up to 32K can be generated. A character R will. 
be printed for all programs that are over 16K but they will be incondition 
to be executed as long as they do not supersede the memory capacity available. 


- The able file with records of more than 256 chatacters will not be 
accepted. 


- If in a TAB I/II program the procedure is very short. The segment that 
contains the CLOSE overlays the adjacent part. In this case insert fake 
service areas, 


- Using the TAB with centers having 3 tape units, an eventual tape substi~ 
f+) tuted for the S.T. must be a file declared in input, 


- In TABUI it is not possible to compile with the "NO-SKIP" switch 
inserted on the printer. 


- There can be no TABII request for reduced segmentation, and, therefore, 
the substitution of the program file by the data file, without execution of 
recovery points, because the . RST order is not then in a position to 
re-create the conditions for restart, 


- The table name must be, preferably, expressed with numerical characters; 
special signs and the following letters cannot be used: J, L, P, S, X. 


- The TAB uses the output files defined VL the same as UN when the length 
of the block ig equal to the maximum length of the records. 


DIFFERENCES BETWEEN TAB II AND TAB IIL IN THE HANDLING OF THE 
CONDITIONS, 


In TAB TI the conditions associated with the type of "record" are set at the time 
of identification of each record and are, therefore, valid only for that well- 
defined type of record to which the conditions have been associated. 


In TAB II the conditions associated with a type of ''record" are set in the rela- 
tive 'troutine" used to handle the first "record" of the type with which that condi- 
tion and that "routine't are associated. The conditions thus set are, therefore, 


associated to all the following "records" used by the same routine, 
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NOTES ~- EDOS 


~ The compilation of the APS source is automatic and an order card 
is not necessary. 


- The macrophrases YCOPY has been added. 


- Automatic optimization of the times of translation and compilatio 
*) when the WORK DISG and the SYSTEM DISC are on different units. 


NOTES ~  ETOS 


In ETOS environment it is mandatory to indicate a start address 
acceptable by the system, that for TAB II it is to be indicated 
in Cols, 50 - 53 of the first general division card (heading 
with * in Col, 24); 2560 ~ Hollerith; 2760 in Bull 1121, 


ETOS/EDOS Limitations 


- It is not possible to compile in TAB the programs whose code 
is composed of the word "END" in column 24, 


EDOS Limitations 


- To punch. tables on cards it is necessary to use partial 
segmentation (Col. 34 card x=N). 
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- Standard printers at 11001/m did not reach the ideal printing 
speed because of binary zeroes (characters which do not 
belong to the graphic set) allocated in the printing area 
(F.R, 245489), 


The compiler did not foresee the handling of the files table 
when this was declared DISORDERED and SEGMENTED (F.R. 321147/ 
230353/320132), 


EDOS Corrections 
For programs wrttten in TAB2 it is now possible to insert the 


START address from col. 50 to 54 of the first card of General 
Division (F.R. 334221). 
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-1G1 - ,TCF - .TGG - .TGP — .TGS 
Limitations 


They may compile only in monoprogramming without CTW. 

The compiled programs may be run only in monoprogramming, with 
CTW only at the condition of fiving up the use of the last 4K 
of memory. 
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»APSP 


The product is the compiler APS, with an option inserted 
for punching the name table of the compiled program. 
The Name table punched on card is necessary for the use 
of ,TESTMON. 

(9) The option is realized with SWITCH1: 
SWITCH 1 OFF normal compilation 


SWITCH 1 ON compilation + punching of name table 


For any other aspects .APSP does not differ from .APS 
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DISKDISK 
NOTES 
~ It is not possible to transcribe the index of an indexed file, 


- It is not possible to transcribe a random file eliminating the 
Oo cancelled records, 


DISKDISK 


Corrections 


7) - When the OUTPUT FULL AREA message was given the first 10-20 
sectors of the following cylinder were destroyed in the DSU160 
or DSUIS7. (F.R. 248532/307035/307039). 


- When the memory was 64K without CTW the tength of the PAGE was 
St in a wrong way (INPUT+OUTPUT). (F.R. 248532/307035/ 
307039). 


‘Mod. 0502 /1 
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INDEX 157 
Limitation 


When creating the index cylinder, the sequential file must not 
have cancelled records (cod = 50) (F.R. 251556). 


Corrections 


Loading is not accepted in DSU160-150-162-110 environment. 
(F.R. 228316/327162). 
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CTDISK 


Corrections 


The character OA was not inserted at the end of the file and the 
file generated could not be used for a search with index. 
(F.R. 318120). 
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NOTE 


The APS assembles the YINDX routine for the DSU 160/162/110 and the 
YIND7 subroutine for the DSU 157. Therefore 2 equal versions of the same 
program , TDISK2 are supplied with the names: 


. TDISK2 for DSU 160/162/110 
. TDISK3 for DSU 157 


If the TDISK3 is compiled on the DSU 160 it is necessary to have the 
parameter DV = 157 in the . APS order card. 
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T 130 - 160 


Limitation 


It works only in monoprogramming without CTS. 


COSA EI” 


Corrections 


- It printed in a wrong way the timer times. (MIN-SEC-DEC). 


- The wrong positionf of the magnetic head on cylinder zero in 
case of DSUI50, caused the alert on unit zero. 
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Limitation 


It does not allow the use of buffered 151/2 (the limitation will 
be eliminated in ET026) (F.R. 334225). 
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TEST MONITOR 


General description 
The basic purposes of Test Monitor are two: 


1} give the possibility to execute, automatically, some 
tests on a software product (coded in APS) with limited 
physical - logical size. 

2) notify in an efficient way the status of the tests 
effected. 


The Test Monitor creates an environment for contral tests 
which is useful for debugging and quality control of 
program unit, this means sections of coded program without 
the possibility té finction autonomously, and coded in APS. 
The Test Monitor allows the user to prove on a wide range of 
data, a program or a program unit and may give all the 
requested results intermediate to.the processing. 


The possibilities are the foltowing: 
- controlled execution of a program unit or a segment as if 
it was a complete program 


catch the instructions which handle the data not present 
in the actual program unit. 


catch the halts to start a new run with new input values. 


similation of each call out of the program unit (subroutines 
or other segments). 

simulation of final points of program unit and automatic 
start of a new run with new data. 


The data may be supplied in one of the following ways: 


- insert constant values in the fields or registers in points 
intermediate to the processing. 


- insert in the fields or registers required, some values 
before each run (the process is automatic) with data 
supplied by the user or generated automatically by the 
Test Monitor itself. 
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In addition for each run, there will be a printout of the 
fields specified by the user both in the intermediate and 
the final points of processing. 


Tést Monitor instructions 


Test Monitor instructions may be of three types; 
declarative, modifyéng, operating. 


NAME 
@eclarative EXIT 
HALT 


eee CALL 
modifying CAPTURE 


operating SENERATE 


fe PRINT 


Environment 
Hardware 


Test Monitor requires as hardware: 


1G 130, 24 K to 64 K memory 
°o 1 card reader 

1 card punch 

1 disc unit DSU160 


Software 


Test Monitur has been designed to function in EDOS 
environment for G 130. In particular it requires: 


«APSP 

-APT 

YLBSS 

YDISC 

YFDTUP 

YDTUP 

SPVAUXM (for x STAND} 
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Test Monitor Usage 


To Test Monitor, it is necessary to proceed with the 
following steps: 


- Compile pwogram unit using as start address (START) 
21000, and .ASP with SWITCH 1 on. 


-Correct formal errors detected by the compiler. 
Keep the cards punched in the last compilation. 
Insert the program on the program file with .API order. 


Code detail cards of Test Monitor describing the 
conditions.to execute the runs (max. 50). 


Load the detail card with those punched during the last 
cempilation. 


INPUT 
Names table 


Test Monitor requires as input} the Names table as punched 
in the last compidation with .APSP. 

These cards, in their sequence, must be before the detail 
cards and f#llow the order card .TESTMON. The progressive 
order number of the names table cards is found in cols. 78-80. 
it is 001 for the first card. The last one is identified 

by 000. 

Test Monitor may use a maximum of 325 names, if the number is 
exceding the user may take out bhe cards containing the 

names which are not used in the detail cards. 

The remaining cards must be in progressive sequence. 


‘Mol, 07 [1 
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J LEC cards only if requested 
by the program 


j+——— detail cards 
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Detail Cards 


Beside the names table, Best Monitor requires in input, the 
detail cards prepared by the user, which must contain 

the following information: 

- name of the program unit to be tested, 

- name of the first instruction from which processingsstarts, 


- logical number of the disc unit where the program unit is 
located, 


maximum number of runs. that the user requires 
name of calls 


names of ajl the instructions which may be final points of 
processing, 


names of the instructions which have bo be taken and not 
executed, 


name of halts that the user wants to catch and simulate, 


names and lengths of fields or registers which must be ~— 
filled with new data each time the execution of the 
program must be restarted, 


the actual value that these fields or registers must 
assume, or the range of acceptable values and the 
increases they may be subject to each time they change, 


name of the breaks where the intermediate data must be 
loaded and names of fields or registers where they must 
be loaded, 


the actual value of the intermediate data values, 


name of the intermediate points of the processing. 


LBC Cards 


If the program unit uses some files, the relative LBC card 
must be included in the card deck in input, after the END 
card of the detail aards file. These detail cards must be 
followed by an END card. 

This second END card must be present even if there are no 
LBC cards. 


Wed om 7 
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Detail cards 


1. NAME Card 
Function: 


Identifies the program unit being teste, its processing 
entrance, the relevant disc unit, and the maximum number 
of runs desired. 


Card Format: 
BNAME = name,LIB=unit,START=first inst. ,RUNS=number 
Description of card fileds: 


name The same name as the one under which the 
program unit was compiled and inserted in 
the program file. The field consists of 
a maximum of 8 alphanumeric characters. 


The logical number of the disc unit on which 

the disc containing the program file in which 
the program unit has been inserted is gounted 
Tne filed consists of one character from D to 


first inst, The name of the first .executable instruction 
within the program unit to be tested, where 
processing is to begin. The field consist of 
a maximum 6 characters for the name, plus 
an optional adjustment of a + dr ~ followed by 
a 2 digit number from 01 to 99. 


number The maximum number of runs desired by the 
user, When this limit is reached, TESTMONITOR 
will go to end of job. The filed consists of 
a 2 digit number. If the field is omitted, 50 
runs are assumed to be the limit, unless 
there are no GENERATE cards, in which case 
only 1 run will be made. The number specified 
in this field should be less than 50. 


Note: 
The NAME card is always required, and must always come first 


in the input card stream, immediately after the symbolic 
name table cards. 
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Only the last field on this card is optional. 


From column 72 on, the card should be biank. 
Example: 


BNAME=TEST , LIB=0, START=STRT+04 , RUNS=30 


2. EXIT Card 


Function: 


Identifies the instructions which can be normal ends of 
processing within the program unit being tested, which are 
to be captured and after which a new run is to begin. 


Card Format: 
BEXIT=name sname,... 
Description of card fields: 


name The name of an instruction which is to 
act as an exit. The field consists of a 
maximum of 6 characters for the name plus 
an optional adjustment of a - or + and a two 
digit number from 01 to 99. 


Note: 


Up to 10 exit instructions can be specified, either on one 
card, or if this is not possible, on two separate EXIT cards. 


An instruction specified as an exit is assumed to be a jump 
that is not to be executed during the TESTMONITOR run. If the 
exit specified does not fit this description, results will be 
unpredictable. If no real "exit" exists, the creation of a 
dummy jump that fits the description above is recommended. 


An exit may coincide with a print break, but not with any 
other type of break. 


An EXIT card with at least one exit instruction name is 
always required. The additional name fields are optional. 


From column 72 on, the card should be blank. 
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Example: 


BEXIT=OUT ,GO+24 , JUMP -04 
3. HALT Card 


Function: 
Identifies all halts within the program unit that the user 
wants siumlated, that is, which are not to be executed and 
after which a reiterative run is to begin. 
Card Format: - 
BHALT=name TAME yo ee 
Description of card fields: 
name The name of an instruction such as the 
one described above. The field consists of a 
maximum of 6 characters for the name plus an 
optional adjustment of a - or a + and a two- 
digit number from O1 to 99. 
Note: 


Up to 10 halt instructions can be specified, either on one 
card,or, if this is not possible, on two separate HALT cards. 


The HALT card is optional. 


Any halts that are to be simulated must consist of at least 

4 octets, so as not to interfere with the instructions 
following. (STOP should be used, instead of HLT in the source, 
if possible.). 


From column 72 on, the card should be blank. 
A HALT cannot coincide with any other type of break. 
Example: 


HALT=NOE+ 28 , ERROR ,HALT4 -02 


Honeywell ATIACHMENT 70 STL NP fer fo [2 [5] oF FW. | | rage 


Honeywall Information Systems Italia 


4. CALL Card 


Function: 


Indicates any calls to outside routines that are to be traced 
but not executed, since the program unit to be tested is to 
run alone. 


Card Format: 
¥CALL=name/length »name/length,... 
Description of card fields: 


name The name of an instruction within the program 
unit as described above. The field consists 
of a maximum of 6 characters for the name 
plus and optional adjustment of a + or - and 
a two-digit number from 01 to 99. 


The length of the parameter string which 
follows the above described call. (For a call 
of the type xLBSS, for example, the length 
of parameters would be 02; for a call to 
another segment, the length of parameters 
would be 04). The field consists of 2 decimal 
characters, from 00 to 16, and is required 
even if there is no parameter string follow- 
ing the call. 


Note: 


Up to 10 calls can be specified, either on one card, or, if 
this is not possible, on two separate CALL cards. 


The CALL card is optional. 

From column 72 on, the card should be blank. 

A call cannot coincide with any other type of break. 

It is up to the user to determine which calls must be 
captured and which can be safely executed during a TEST- 
MONITOR run. 

Example: 


KCALL=PRINT/O2 , TYPE+10/00, INST-04/06 


Mod. 050% [1 
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§, CAPTURE Card 


Function 


Identifies any instructions within the program unit that are 
not executable, since the fields they deal with lie in other 
program units. 


Card Format: 


BCAPTURE=name ,name,... 


Description of card fields: 


name The name of an instruction within the 
program unit such as the one described 
above. The field consist of a maximum of 
6 characters for the name plus an 
optional adjustment of a + or ~ and a 
two-digit number from 01 to 99. 


Note: 


The maximum number of instructions that can thus be 
captured is 15, and they are to be indicated on one or 
more CAPTURE cards, 


The CAPTURE card is optional, but it must be included 
if any instructions of the type described above exist, 
or execution will produce unpredictable results. 


A capture cannot coincide with any other type of break. 


From column 72 on, the card should be blank. 
Example: 
BCAPTURE=ADD-04 ,DIV+12 


° 
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8. GENERATE Card 


Function: 


Specifies a set or range of values for data to be provided at 
the start of each new reiteration of the program unit being 


tested. 
Card Format: 


WGENERATE: 


BGENERATE: 


Description of 


field 


a (11) =type'minimum-maximum/incr. 
field = 
reg. (11) =type'value yValue,... 


card fields: 


The name of the field to which data is to 

be supplied, consisting of a maximum of 6 
characters for the name plus an optional 
adjustment of a + or - and a two-digit number 
from 01 to 99. 


The identification of a register to which 
data is to be supplied, consisting of 3 
characters from R.O to R.O. 


The length of the field or register to be 
data-filled, specified in decimal as the 
number, of bytes surrounded by parentheses, 
that is, (01) to (16). 


This field can be left out if the desired 
length is the same as that defined for the 
field during compilation. If the defined lengt 
lenght is greater than 16, however, 16 is 
assumed, and the actual value .specified on 
the card must be 16 characters long. For a 
register identification, if this field is 
omitted, a length of 2 is always assumed. 
If the field name contains an adjustment, 
however, and thus no defined length exists, 
this length must appear on the card. 


A code indicating the mode in which the 
values that follow are to be interpreted. 
The possible types are: 


Cc - character mode, decimal value 


"Mod 0302 /1 
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X - hexadecimal mode, binary value 
S - hexadecimal mode, signed packed value 
R - hexadecimal mode, unsigned packed value. 


One type code applies to all the values, 
minima, maxima or increments on any one 
GENERATE card. 


The data that is to be moved into the 
specified field or register, to consist of 
a maximum of 32 characters (in hexadecimal 
mode) or of 16 characters (in decimal mode). 
The values specified for any one field or 
register must all be of equal length, to 
match either the length specified on the 
card or the length defined for the field 
during compilation. 


ninimum The lowest desired value for the data field 
or register in question, conforming to the 
characteristics described for the parameter 
"value" above. (Exception: for data type P, 
the maximum length is 16 characters, not 32). 


maximum The upper limiting value, inclusive, for the 
data to be generated in the field or register 
constructed physically like the "minimum" 
parameter above and being of equal length 
with it. 


The increment which is to be used in 
generating the required data. This field 

has the same characteristics as the "minimum" 
parameter, except that it can be only half 

as long. For data type S$, the increment cannot 
be longer than the minimum or maximum fields, 
Generation proceeds by the’ addition of this 
increment to the minimum until the maximum 

is reached.The type of addition (binary, 
decimal, signed or unsigned packed) depends 
on the type code specified in front of the 
minimum parameter on the card. 


Note: 
For the second type of GENERATE card, that which indicates 


a set of values, all the needed values may not fit on one 
card. In this case, the last complete value that does fit 
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should be coded, followed by a blank. Additional values must 
be coded on a new GENERATE card, immediately following in 
the input card stream, on which all the field identification 
is repeated. No continuation is possible from card to card. 


If both a range and a set of individual values are desired 
for any one field or register, the card specifying the range 
of generation must come first, followed immediately by the 
card specifying the set of value, for which all the field 
identification information is repeated. In addition, length 
and othercharacteristics of the field must be exactly the 
same. If the length field, for example, appears on the first 
card, it must also appear on the second. 


The number of fields for which generation can be specified 
depends on the lengths of the fields in question and on the 
number of values specified for each. 


When generation of data for more than one field or register 
is desired, a separate card must be used for each field or 
register to be filled. 


The card must be’ blank from column 72 on. 


The GENERATE card is optional. If no GENERATE cards are 
included in the input card deck, only one run of the 
program unit will be made by TESTMONITOR. 


If a GENERATE card is present, reiterative runs of the 
program unit will continue until all the possible values 
of the lengest data set have been used up, or until. the 
run maximum is reached, whiever occurs first. When any of 
the shorter data sets ends, generation begins again for 
that field at either the first actually specified value 
or at the minum. 


Generation is performed always before a reiterative run is 
to begin. 


Examples: 


WGENERATE:R.1=X'6544,6F89 
JGENERATE : FEELD+02 (05) =C'00000-99999/100 
BGENERATE: CONST-15 (02) =K'412-43BA/0A 
WGENERATE : PACK=P' 546754 3034256, 980643 
GENERATE : SIGNED(02) =6' 234C,1420 
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7. PUT Card 


Function: 


Request that data be supplied at intermediate points 
(data breaks) in the processing of the program unit being 
tested, 


Card Format: 


BPUTBATKbreak: field 


reg: (11) =type value 
field 


> reg. (11) stype'value,... 


Description of card fields: 


break The name of the instruction resident at 
the point in processing when data is to 
be supplied. The field consists of a 
maximum of 6 characters for the name 
followed by an optional adjustment of a 
+ or - and a two-digit number from 01 to 
99, 


The name of the field to which data is to 
be supplied, consisting of a maximum 6 
character name followed by an optional 
adjustment of a + or - and a two-digit 
number from 01 to 99 


The identification of the register to 
which data is to be supplied, consisting 
of three characters from R.O to R.7. 


The length of the field to be data filled, 
consisting of 2characte rs surrounded by 
parentheses, (01) to (16) only. This field 
can be omitted if the desired length is 
that compiled for the name, but if the name 
is given with an adjustment, no compiled 
length is available, and therefore, this 
field must be specified. If the compiled 
length is greater than 16, 16 is assumed. 
For a register identification, the omission 
of this field will cause an assumption of a 
length of 2. 


Med. oa? Jt 
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A code indicating how the value that follows 
is to be interpreted. The possibilities are: 


C : decimal configuration 
X : hexadecimal configuration 


The data that is to be supplied to the 
field or register in question when the data 
break occurs. The field consists of a 
maximum of 32 characters, for hexadecimal 
mode, or of 16 characters, for decimal mode. 


Note: 


Only one value for each field or register can be specified 
for any one run, but additional field or registers to be 
filled at the same data break can be included on one card 
as long as a complete specification, including the entire 
value, will fit before column 72. If other fields or 
registers are to be filled at a particular data break, but 
will not fit on one PUT card, additional PUT, cards must be 
coded, repeating data break name, etc. 


The card should be blank from column 72 on. 


The requested data is upplied in.all cases before the 
instruction resident at the data break is performed. 


Data breaks can coincide only with a print break, but not 
with any other type of break. 


The number of data breaks and associated fields that can be 
specified depends on the lengths of the values indicated. 


The PUT card is optional. 
Example: 


BPUTPATBINSTR: FIELD-14 (04) =C'12,R.3=x'45B8 ,CONST=C' 4096 
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8, PRINT Card 


Function: 


Specifies information relating to print breaks, that is, 
to points within the processing of the program unit where 
the contents of fields or registers are to be displayed. 


+) Card Format: 


field 
> reg. 


an ' 
perintgaTp PALT , field 


(11) (11) yee 


reg. 


Description of card fields: 


break The name of the instruction resident at the 
point in processing when the printing is to 
occur. The field consists of a maximum of 
6 characters for the name, followed by an 
° optional adjustment of a + or - and a two- 
digit number from 01 to 99. 


The name of the field whose contents are to 
be printed, consisting of a maximum of 6 
characters for the name plus an optional 
adjustment of a + or - and a two-digit: 
number from O1 to 99. 


The identification of the register whose 
contents are to be printed, consisting of 
3 characters from R.O to R.7. 


The length of the field to be printed, 
consisting of a two-digit number surrounded 
by parentheses, from (01) to (16). This 
field can be omitted if it is desired to 
display a field for its compiled length. 

Jé the field is specified with a name and 
adjustment, however, the length must appear 
On the card. If the compiled length is 
Sreater than 16, 16 will be assumed. 


Note: 

oO The PRINT AT HALT option can be used to ask for a 
display of field contents if any of the halts indicated 
on the HALT card occurs. 


The requested 


Mes, can 1 
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The requested display always takes place before the 
instruction resident at the print break is executed. 


It is required that all the HALT cards in the input deck 
will come somewhere before any PRINT AT HALTs. 


The maximum number of print breaks that can be specified 
depends on the number of field/registers connected with 
each of them. 

The card should be blank from column 72 on. 

As many fields/registers for the same print break as will 
fit before column 72 can be specified “on one PRINT card. 
For additional field/register, a new PRINT card must be 
coded, repeating the print break name, etc. 


Print breaks can coincide with exits or data breaks, but 
not with any other type of breaks, 


The PRINT card is optional. 


Examples: 


BPRINTBATBINSTR: FIELD ,R,1,R.7,CONST+10(16} 
BPRINTPATBHALT:R.2,R.4,FIELD-02(07) 


9. END Card 


Fenction: 
Indicates the end of the input detail card stream. 
Card Format: 


BEND 


Note: 


The END card is required, and must always be the last card 
in the detail card deck. 
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VI. OUTPUT 
The output of TESTMONITOR consists of the following: 


1. Print out of input: Each of the input detail cards 
is printed on a separate line, single spaced. Any 
LBC cards are printed starting at the top of the next 
_ page, also single spaced. 


Page heading: Shows the name of the program unit 
being run with TESTMONITOR and the page number. 


Run heading: Information relating to the separate 
reiterative runs is set off for easy scanning by 
a line of asterisks identified with the number of 
the run. 


Information relating to each run: First, any input 

for the run is displayed, two fields to a line and 
identified with the fild name and address. The field 
contents are displyed in hexadecimal, and so are 

the addresses. (For each line showing field contents, 

a translation line showing the possible corresponding 
character configurations also appears). 

At each print break during the run, the requested 

field contents are displayed in the same format as 

on input. At each data break, the fields supplied with 
data are also printed, along with data break identificatio 
Lines tracing outside calls and identifying any halts 

or exits taken will also appear. Along with a halt 
identification will also appear the display of any fields 
which were requested with the PRINT AT HALT option. 


§. Normal and error messages: See section X for details. 


The amount of output is limited by the maximum number of 
run specified by the user on the input NAME card, or failing 
that, by the assumed maximum of 50 runs. 


An illustration of the various output layouts will be found 
on the following page, showing the possible output lines 
for any one run of the program unit being tested. A key to 
the symbols used in the layouts will be found on the page 
following the illustration. 
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IX. LIMITATIONS AND RESTRICTIONS 


The following is a list of restrictions upon the use of 
TESTMONITOR that are gathered together here from various 
other sections of this manual for easy reference. 


1. 


20 


TESTMONITOR requires at least 24 K of memory. 


The program unit being tested cannot take up more than 
3 K if TESTMONITOR is to run in 24 K. 


The program unit must be compiled especially for TEST- 


: MONITOR to a fixed start address of 21000, and with 


the .APSP or .DSPSP option to punch out the name table. 


Dummy definitions for any outside names that are flagged 
as undefined by the compiler must be added to the program 
unit so that a clean compilation can be achieved. 


The program unit can consist of only one segment, though 
CALLS to other segments can exist within it, as long as 
they are properly identified on a CALL card. 


Instruction modification or address modification within 
the program unit will give unpredictable results if 
occurring at or referring to the control break points. 


The NAME card must always be the first card in the input 
deck following the name table. 


The NED card must always be the last card in the detail carl 
card section of the input deck. Another END card must f 
follow any LBC cards, and must be present even if LBC cards 
are not there. 


At least one EXIT name must be specified. 


The numbers of the. various control breaks are limited 
according to the numbers and lengths of the fields 
involved, by the sizes of the various internal tables. No 
specific maximums can therefore be given here. 


Control breaks, except CALLS, cannot occur at points in 
processing where a JRT is followed by paramters being 
passed. 
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System halts cannot be captured during a TESTMONITOR 
run; only halts within the program unit that are specified 
on the HALT card ean be captured and simulated. HALTS must 
take up at least 4 octets, that is, a STOP should be 
used instead of a HLT. After a HALT, TESTMONITOR will 
reiterate the processing of the program unit from the 
beginning; no continuation of in-line program unit 

‘ processing is possible after a HALT has been simulated. 


Data breaks can coincide only with print breaks; print 
breaks can coincide only with exits or data breaks. (When 
both a print and a data break are specified at the same 
point, the printing is always performed first, followed 
by the supplying of the data.) The specification of 
forbidden combinations of contrel breaks at the same 
point will give unpredictable results. 


If any instructions that have been compiled with dummy 
addresses are not identified on CAPTURE cards, the 
results will be unpredictable. 


Any EXITs must be jump instructions that are not to be 
executed, or results will be unpredictable. 


The total number of print and data breaks cannot exceed 60. 


The program unit cannot contain more than 325 names. 


Enough free space must exist on the disc which contains 
the program unit in its program file to also contain the 
TESTMONITOR-modified version of the program unit in 
question. 


Because of the way that control breaks must physically be 
inserted into the program unit, the points at which they 
are specified are subject to certain limitations: 


a. At HALTs, EXITs and CALLs, the resudent instruction 
must consist of exactly 4 octets, since this many 
have to be displaced, in order that surrounding 
instructions not be interfered with. 


At print or data breaks, the resident instructions 

can be of any type, with the restriction that the 8-12 
octets to be displaced contain only valid instructions 
(not constants) and are not modified from within the 
program unit or by way of a PUT or GENERATE statements. 
In addition, only the first instruction of these 8-12 
octets can be jumped to from within the program unit. 


‘Ned. osm [1 
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(The 8-12 octet limitation exists since at least 8 
octets are needed for the insertion of the break 
instructions, and certain combinations of resident 
instructions, such as a pair of 6 octet instructions 
following each other, will require that up to 12 
octets be removed, since only whole instructions 

can be displaced.) 


Oo 20. No physical part of the program unit can lie below 
21000. That is, a constant cannot be defined with a 
DC anywhere below that point, though a DS can be used 
to give a name to an area of memory below it. 


X. MESSAGES 


° A. Normal Messages 
Cause ; normal end of TESTMONITOR processing 


Message : END OF TESTMONITOR 


Bffect + halt 


a Oe 1 
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B,. Error Messages 


TESTMONITOR produces two types of error messages; one type 
Tesults from the card scn, and consists always of the same 
message "INVALID DETAIL CARD" followed by a two-digit 

number, whose possible significances are explained below, 
The second type’of message relates to any other type of 
error found, and the various messages of this second kind are 
described in detail, in alphabetical order, right after the 
Invalid Detail Card codes. 


CAUSES OF INVALID DETAIL CARD MESSAGE CODES 


SIGNIFICANCE 


a NAME card does not precede the other 
detail cards 


02 a detail card contains an invalid identifi- 
cation (is not a NAME, EXIT, PUT, PRINT, 
GENERATE, CALL, or HALT) 


03 two NAME cards are found in the input card 
stream 

04 number of runs specified is invalid: not 01 
~ 50 


slash separating the “length of parameters" 
field from the call name on the CALL card 
is invalid 


06 a specified length is invalid 

O7 an equal sign is missing or is incorrectly 
placed 

08 data type on a GENERATE card is invalid: not 
X,C,P,S 

og the first value on a card doesn't end with 
-; or 

10 a later value is not followed by a , or a & 

1l a name with adjustment is not followed by 


the length specification 


12 a hexadecimal value contains other than hexa 
decimal characters (0-9, A~F) 


13 a name is missing or contains special chrts. 


Mod, 0802/1 
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CAUSES OF INVALID DETAIL CARD MESSAGE CODES 


SIGNIFICANCE 


a specified name is longer than 6 chrts. 


a specified name, including an adjustment, 
if present, is followed by an invalid 
special character 


the adjustment specified on a name is 
invalid 

a length specification is not followed 
bya ) 

a range type GENERATE specification follows 
another GENERATE specification for the same 
field 


the slash separating the maximum and 
increment fields on a range type GENERATE 
card is missing or invalid 


the increment field exceeds 16 characters 
on the card {or 8 characters internally) 


for an increment specified in hexadecimal, 
the number of characters on the card is 
not even 


values for unsigned packed generation (data 
type P) are longer than 8 characters 
internally 


colon (:) missing or incorrectly placed 
equal Sign (=) missing or invalid 
data type is invalid for a PUT: not X or C 


a complete specification on a cards is not 
followed by a comma or a blank 


the program name is longer than 8 chrts. 


the disc unit number is invalid (not 0-9 
or A-F) 


the minimum value in.a range type GENERATE 
specification is not less than the maximum 
value 


the increment in a range type GENERATE 
specification is not positive 
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: An error in an earlier GNENERATE card may cause TEST- 
MONITOR to make an assumption that will cause errors 
in the analysis of a later GENERATE card for the same 
field 


In attempting to write out the modified 
program unit on disc, TESTMONITOR finds 
o that there isn't enough free space available. 


Message DISC FREE SPACE INADEQUATE 
Effect : Halt 


Action ‘ Clear enough space on the disc to. contain 
the program unit being tested. This means 
that 1 sector of the disc must be available 
for each 288 characters of the program unit. 


In reading the cards following the first 
END card (the one ending the detail card 
stream) a card is found that is not either 
an LBC card or an END card or more than 10 
LBC cards were found. 


+) Message : ERROR IN LBC CARD DECK 
Effect Halt 


Action ;: Examine LBC cards and correct any errors. If 
no LBC cards are needed, make sure that a 
second END card stiil follows the first one. 


A control break has occurred and there is 

no corresponding entry in any of the break 
tables, or there is no corresponding entry 
in the removed instructions table. Therefore, 
processing of the program unit cannot be 
continued. 


(+) Message ; IMPOSSIBLE TO PROCEED 
Effect Halt 
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Action ; Check the input to see if all breaks were 
specified at acceptable points; especiall 
verify that no modification of instructions 
resident at break points is being attempted 
from within the program unit or via a PUT 
or GENERATE card. Correct the error and 
start again. 


oO 4 A name or a name and adjustment specified 
on a detail card for an instruction at which 
a break is to occur does not correspond to 
an even memory address. 


Message : Xxxxxxxxx INVALID INSTRUCTION ADDRESS 
(where xxxxxxxxx is the name and adjustment 
in error) 


Abort switch is set, and processing 
Oo continues with the next detail card. 


Correct name or adjustment in error so that 
it actually corresponds to a valid address. 


In reading the name table, the last card, 
which should be numbered 000, is found to be 
missing. 


Message : NAME TABLE MISSING OR INCOMPLETE 
Effect : Halt 


Action Restore name table to the way it was when 
it was originally punched out by the compiler 


During the reading of the symbolic name table 
a.card is found to be out of the normal 
ascending order, or the last card is missing. 


Message ; NAME TABLE OUT OF SEQUENCE AFTER xxx 
(where xxx is the number of the last properly 
ordered card) 


The abort switch is set and processing 
continues with the next card. 
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Examine the sequence numbers in columns 78-80 
of the deck and correct the error. 


7. Cause : All the detail cards have been. scanned and 
the one required EXIT has not been found. 


” Message NO EXIT SPECIFIED ON DETAIL CARDS 
o Effect : Halt 


Action Code up an EXIT card with at least one name, 
add to the detail card deck and start again 


8. Cause ; A name specified by the user on a detail card 
does not have a corresponding entry in the 
Name Table 


Ce] Message xxxxxx NOT IN NAME TABLE 
(where xxxxxx is the name specified by the 
user) 


Effect The abort switch is set and processing 
continues with the next detail card. 


Action Examine the name on the detail card to 
determine whether it has been misspelled 
fe} or mispunched. Correct the error and start 
again. 


9. Cause : The program file has been searched and the 
indicated program unit is not present. 


Message XXXXXXXX NOT PRESENT IN PROGRAM FILE ON n 
(where xxxxxxxx is the name of the program 

unit as specified on the NAME card by 

the user, and is the disc unit number) 


Effect : Halt 


Action Compile and insert program unit’on 
appropriate disc, correct name specified on 
the NAME card, or correct disc unit number 

(+) specified, if erroneous. Start again. 


—— 
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10, Cause 


Message 
Effect 


* Action 


11. Cause 


Message 
Effect 


Action 


12. Cause 


Message 
Effect 


Action 


13. Cause 


Message 
Effect 


Action 


Not enough room in the Call Table to handle 
all the specified calls 


OVERFLOW IN CALL TABLE 

Halt 

Reduce the number of CALL names specified to 
the maximum of 10. Start again. 

Not enough room in the Capture Table to 
handle all the specified capture names. 
OVERFLOW IN CAPTURE TABLE 

Halt 

Reduce the number of capture names specified 
to the maximum of 10. 

Not enough room in the Data Break Table to 
handle all the PUT requests. 

OVERFLOW IN DATA BREAK TABLE 

Halt 

Reduce the number of data breaks requested, 
and/or the number of data fields or 


registers to be supplied with data and their 
associated lengths. Start again. 


Not enough room in the Exit Table to handle 
all the specified halts. 


OVERFLOW IN EXIT TABLE 


Halt 


Reduce the number of exits specified to the 
maximum of 10. 


Mod. 6802 1 


Honeywell amscamentto sre nele ff Lolz 5 J ow. [| rage 


Honeywell Information Systems Italia 


14, 


Cause 


Message 


Effect 


» Action 


1s. 


Cause 


Message 
Effect 


Action 


Not enough room in the Generate Table to 
handle all the GENERATE requests. 


OVERFLOW IN GENERATE TABLE 

Halt 

Reduce number of fields or registers to be 
Supplied with data, or reduce number of 


values to be supplied, as a set, for some 
of the fileds or registers. 


Not enough room in the Halt Table to handle 
all the specified HALTs. 

OVERFLOW IN HALT TABLE 

Halt 

Reduce number of halt names specified or 


reduce number of fields requested with any 
PRINT AT HALT cards. 


Message 
Bffect 


Action 


Cause 


Message 
Effect 


Action 


In reading the symbolic name table deck, it 
is found to contain more than 325 name 
definitions. 


OVERFLOW IN NAME TABLE 
Halt 


Reduce the size of the program unit so that 
the limit of 325 names can be observed or 
remove those cards from the name table deck 
that contain definitions of unused names. 


Not enough room in the Print Break Table to 
handle all the PRINT requests. 


OVERFLOW IN PRINT BREAK TABLE 
Halt 


Reduce number of print breaks and/or number 
of fields or registers associated with them. 
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Message : 


* Effect 


Action 


While leading the program unit, TESTMONITOR 
finds that the program unit has not been 
compiled to a high enough address not to 
overlay part of TESTMONITOR itself, 


PROGRAM COMPILED TOO LOW 
Halt 
Modify and recompile the program unit so that 


no part of it will fall below the established 
minimum of 21000. 


Message : | 


Effect 


Action 


The maximum number of runs (either as speci- 
fied on the NAME card or the assumed maximum 
of 50) has been reached. 


RUN MAXIMUM REACHED 


Processing is discountinued and TESTMONITOR 
goes to end of job. 


If further output is required, increase the 
number of runs specified or add another job. 


Cause 


Message : 


The disc mounted on the indicated disc unit 
is not a System Disc. 


SD NOT PRESENT ON n 

(where n is the logical number of the disc 
unit) 

Halt 


Mount correct disc on indicated unit, or 
correct the number specified on the NAME card. 
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21. Cause : The abort switch is found to be on after all 
the input detail cards have been analysed, 
indicating that there was at least one 
erroneous detail card. 


TESTMONITOR ABORT - INVALID INPUT 
Halt 
° Examine the preceding list of detail cards a 


and correct any in error, that is, those 
that are followed by an error message. 


Too many control breaks neet to be inserted 
into the program unit and Removed Instruc- 
tions Table capacity is exceeded, 

) Message : ‘ TOO MANY CONTROL BREAKS SPECIFIED 


Effect : Halt 


Action Reduce Numberof print and data breaks to the 
maximum total of 50. 
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Products not documented in a standard mode 


The following products, which are not documented in a standard 
mode, have been inserted in this distribution: 
Print to tape and tape to print automatic conversion 


described in S.A.A. n. 1 January '73 cod. 3904560H (Italian) 
S.A.A. n. 4 June ‘73 cod. 39045630 (English) 


YPTT tape to print conversion for monofile volume 

YPTTU tape to print conversion for multifile volume 

PRT 

: rans These orders use SUB YMSGP 

te : Auxiliary orders to handle the CTW 

TPCONVE concurrent program of tape to print conversion for - 
monofile volume 

TPCONVU as above for multifile volume 

TPCONVEM main program of tape to print conversion for 
monofile volume, 


These orders use SUB YMSGPC to handle the CTW. 


Access in Update/input to the same file by two programs in 
Alternance/Coexistence (described in FLASH n. sf - August 4 1972). 


YPROTE 


Time-out handling in Alternance/Coexistence (described in 
FLASH n. 53 - August 4, 1972) 


YTIMEO handling by program 
-YTIMEQUT consol intervention (it uses the SUB YMSGP and YTIMEO) 


Transfer and physical duplication of disc volumes; whichever is 
their contents (described in FLASH n. 53 - August 4, 1972) 


+ BOTT Basic Disc to tape main order 

-WOTT Work Dise to tape 

«TTHD Tape to work Dise secondary orders 
-OTWD Disc to work disc 


These orders use SUB YWNBE and YMSGP. 


The transfer is allowed for disc types equal to 110/150/160/162/ 
1573 transfer from discs 160 to 157 is allowed through tape 
noting that for program files, the program which access through 
inxed must be recompiled and for files with index, they must be 
recopied on another volume. 
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BDTR_UTILITIES/ . TDISK 1 


1, 


EXTERNAL SPECIFICATIONS 


It serves to transfer on disc the file of the BDTR subroutines from the 
GAS tape. It is a program complementary to the subsequent . TDISK2 
and they have been implemented to be able to compile the BDTR T & D. 
applications on centers only with dises, obtaining the complete listing 
of the compilation, 


In order to use this program, it is necessary that the subroutines are 
organized according to the .GAS procedures and which do not have the 
macros APS -STRT - END at the beginning and at the end. 


2. AUXILIARY PROGRAMS 


2.1. DSU 160/162/110 


In order for the subroutines file on dise to he subsequently usable by 

. TDISK2 program, it is necessary to generate the index cylinder with 
the "INDEXING" program, For the specifications of such a program, 
refer to the documentation existing on the subject. For the mode to 
use it in this particular case, the list is given here 
below of the cards necessary to the index cylinder generation 


LOAD, INDEXING 
#LBC, INDEXING, INPUT, FN =TDISK1, MU =.0, CO =/NNNNN 
BEND 

PARAO080144006F8, 


Such a program naturally must be launched after the file has been correctly 
transfered on dise from the . TDISK1 program, 
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2.2. DSU 157 


If the transfer occurs on disc 157 it is necessary to generate the index 
cylinders with the "INDEX 157" utility program(see SPS 1B No, 1530 
July '71), 


The indicative tracing of the generation and launch cards is the following: 


. LOAD, INDEX 157 
END 
PARA 0080144006F8 INDX BDTR 


(col, 40) 
Note =In col, 40 there is any identification name. 


. APS, INDXBDTR, ID =SD, NL 

. API, INDXBDTR 

. LOAD, INDXBDTR 

KLBC INDXBDTR, INPUT, FN =TDISK1, MU =0, CO = 4NNNNN 
END 


8. USE PROCEDURES 


3.2. 


In) aration 


Assemble .GAS tape on unit No. 5 and to assign the logic zero 
number to the dise (preferably the system disc) on which the file 
has to be transferred. 


Reserve a dise zone with the .SFD card. 
Limits: 


a) 
b) 
c) 


the zone must stay on the disc with logic zero number, 


the file name must be "TDISK1"" 


the writing mode must be 8 bits, 
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SYSTEM 


An example of such a card may be the following: 


-SFD, 0, 000001, TDISK1, RM = 8, 000001, 01, F, ME =32, IC, 


3,2, 


Output interpretation 


- The output on disc is given by the subroutine file in source. The 
subroutine code (col. 73/78) is transferred in col, 2/7 (it will be 
the key for the subsequent indexing program), All the contents of 
the record (col. 2/72) are shifted of six positions to col, 8/78, the 
columns 79 and 80 are set to blank. 


It writes blocks of 1440 chrts, records of 80 chrts (pages of 5 
sectors - 18 records/page ~ 30 records/cylinder). 


- The output on printer is given by the list of messages that summa-— 
rize the results of the whole processing, The messages in parentheses 
may show only in exclusion, 


MSG 1 =Source card transferred: XXXXX 

MSG 2=D,T. Subroutines transferred : KXX 

MSG 3 = Subroutine list: 
Name i, Name 2, .... Namen 

MSG 4 = bre subroutines are present on tape No. 5 
No subroutines have been transferred 


Dise zone reserved for file is not completely filled (A 
MSG 5= Soi zone reserved for file is completely filled B 
The disc zone reserved for the file is not sufficient (C 
Free sectors left: XXXXX (A 
= (B 
MAG 6 = = not transferred: XXXX c 
Sectors needed: XXXXX . 
Punch and load the following order to (A and (C 
MSG 7 = fous the space reserved for the file: 
= B 
(SFU, 0, 000001, TDISK1, ME =RE A 
MSG 8 = = = B 
(.SFU, 0, 000001, TDISK1, ME =XX (or 
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Reduces the space reserved to that actually occupied (A 


MSG 9 = = = = (B 
Increases reserved space to indicated number of 
cylinders (4 
MSG 10 = ( Transfer completed (A and (B 


( Transfer not completed (C 

MSG 11 = File label - TDISK1 ~ not found or DISC No. 0 - impossible té 
proceed - reload the program 

MSG12 = Check out phase 

MSG13 =Check is bypassed with switch 1 on press operate 


Check out completed @ 
MSG14 = (Check out not completed 
Check out bypassed (eu 


Note: In case (MSG 6-A) the number of sectors remained free is smaller than 
100, the subsequent MSG 7 ~ MSG 8 - MSG 9 do not show, 
In order to avoid an EIOS HLT in the opening phase of the TDISK file, if 
absent, the MSG 11 shows, 
Only in the case the transfer has been completed (MSG 10 - A) the subse- 
quent MSG 12/13/14 show. 


3.3. Operation instructions 


The program is launched with the order card . TDISK1. 
Order card format: 

eo, L=- 7=,TDBK1 

col, 1 - 80 = not used 


Therefore summarizing all the necessary operations (see point 2 and 3.1.): 


a) 


Assemble the file tape on munit No.5 


b) Assign to the disc, on which to transfer the file, the logic number zero 
(in the case of the BDTR it will always be the system disc), 


ec) Reserve the "TDISK1" disc zone and the related index cylinder, 
d) Launch the "TDISK1" program 
e) Launch the "INDEXING" program (or INDEX 157) 
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At this point the file on disc is set to be used by the subsequent . TDISK2 
program. (or TDISK3), 


NOTE: 


At the end of the transfer, after the printing of the results, it is possible 
to accomplish a re-reading of the tape and of the disc for check. This 
phase is signaled by MSG 12/13 on the printer, which is set by program 
in STAND BY. 


The pressure of the key OPERATE enables the check. 
The pressure of SWITCH 1 and OPERATE excludes the check (MSG 14-F). 


Incase a discrepancy is noted between the record read on tape and the 
one written on disc, both are printed in hexadecimal followed by the 
MSG 14-E. 


The following messages: MSG 10 C - MSG 11 - MSG 14 E block the proces- 
sing on ABORT (02A6) and impose the launching again of the program. No 
other HLT is planned. All the messages are planned for a printed line of 
104 characters, 


This program is valid for: 


- 9-tracks tapes - GUN 7/9 or P.M. 
- DSU 157/160/162/110 
- EDOS 4, 
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.LTDBK1 Program 


Purpose 


The program prints the {nformation of the last record of the BDTR subroutines 
contained in file TDISK1. 

Use of the installation 

-  1econsole teletypewriter (optional) 

-  lLceard reader 


~ 1 printer 
(9) -  Idise handler 6.D.) 


Order card description 

. LTDBKI 

Messages 

*END OF LTDISKI : order end message 


Inpur 


- Order card 
-  TDISK1 file on S.D. zero logic unit 


OUTPUT. 


- Printing of the BDTR subroutines information, 


‘Nod 0567 7 


tc 
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Operation logic 


a) 
b) 


c) 


The program reads the TDISKI file and prints the title. 


It stores the name of the subroutine of the record read, 


It compares the name of the stored subroutine with the name of the read 
subroutine, 

For an equal subroutine it brings in printing area the record read, reads 
the file TDISK1 and goes to point c). 

For not equal subroutine the record {s printed in print area and goes to 
point b). 

When the file end TDISK1 occurs, 2 print is made of the last record in the 
print area, of the total of the subroutines of the TDISKI file. 

if the TDISK1 file is empty, the message is printed: "TDISKL FILE 
CONTAINS NO SUBROUTINE”, 


NOTE: the TDISK1 file must be present on the System Disc zero logic unit. 
If the file is not defined an ALERT occurs on the zero logic unit. 
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EDOS Programmer Manual - Vol. 1 


~PLCK 


. Function 
It checks transcription of the programs file executed by the 


order program .PFCP and .PLTR as tong as the file has not 
been packed. 
Program considerations 
4) The file packing may be detected by comparing the final 
addresses of the programs library on the two discs. 
_PLIR 
c. Program considerations 


6) The file packing may be detected by comparing the final 
addresses of the programs library on the two discs. 


EDOS-LIBRARY DISC 


Type 1 programs must be included within the first 288 programs, 
so that they appear in the programs index within the first 40 
sectors reserved for it. 
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"RPG" Manual 


The following sentence has been added to the paragraph “Structure 
and contents of the file description specifications": 


Columns Description 


35-38 These columns. are Teft blank if in the input 
description module the Field Location: From and 
the Field Location: To already define the 
beginning and the end of a key field. 


RPG Manual 


The following note has been inserted in paragraph "Error notes 
printed by input scanning program": 


NOTE 181 - Field-Record Relation Indicator not 
found in this file. 
Specification is not processed. 


"od. coat | 
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"APS Language" Manual 


Paragraph C. "Instructions description” - 1. Organization 
description 


NOTE (1) - the following sentence has been added: "To use xLBSS 
the values must be increased by 150". 


ed, 0502 71 


Honeywell ATTACHMENT TO «STL N° elr b [2[5| oF FW. FJ reae | G 05 


Honeywell Information Systems ilalia 


ETOS Programmer's Manual 


PG 
APS card has been updated. 
Column 15 x if compilation list is not requested 


columns 16-49. program list heading. 


GAF 
The following messages have been updated or inserted: 
Rexx CARD-PUNCH NOT CONNECTED 

The extraction of a program on card punch while 


no card punch is connected with the system, has 
been requested. 


During punching verification these words identify a 
couple of records filed and card in reading which. do 
not result equal when compared; the characters not 
matching are marked with character 


WRONG E/S CARD 


It has been requested the elimination of the card 
record STRT or END or its substitution with a card 
different from STRT or END respectively (only for APS 
programs); or the last record number to be eliminated 
is smaller than the first record number. 


The request is not executed. 
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xxxxx END OF SOURCE PROGRAM 


This message appears after printout of the last 
card "comment in case of extraction on tape 
for compilation. 


SOURCE DATE INVALID (OR MISSING) 


This message appears, in case of extraction on tape, 
when the card "comment" is missing before the final 
card, or when col. 32-36 of this card do not contain 

a numeric value. Loading of col. 32-36 is not executed 
in the area reserved for the date and there is a HLT 
at O2A6. 


Particular rules 


Provide loading in the file of a fictitious program having coda 
YYYYYYYY which might be formed by anyone card. If this 
program is not present, it is not possible to execute the 


check of the last program existing in the file or substitute 
the last card. 
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Following is the new version of the information concerning 
column 


59 N, if the blocks are not numbered 
WB, in the opposite case 
This column is taken into consideration only if DS is in 
col. 5/6. 

The following message has been added: 


5188 x INPUT NOT SYSTEM TAPE OA26 
(option DS is given in col. 5/6 and the tape 
in input is not a SYSTEM TAPE, L.TAPE, M.TAPE). 


At the end of paragraph C. “Memory reserved area" the following 
note has been added: 


Programs allocation addresses in M.T. environment 


If a program using xLBSS is included in M.T. it requires that 
the programs preceding its execution, have the same allocation 


address not smaller than 2560 (HOLL.) or 2760 (BULL). 
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Sofware Library Management_Manual 


1) 


Paragraph "“NS99 - EDOS Conversion Program from Tape 
to Disc" 


Operating Rules 


Parameter Card updated: 
Column 1 card code "x" 


Columns 21-22 order number of the first disc unit 
DSU110 connected with the system 
(ex.: O1, 02, ...) if rewritten on 
disc 110. 
bb if rewritten on disc 160. 


»EXSP - Particular rules 


"The first source program card must have number one 
(col. 2-6 of APS listing)". 


"The program uses backward reading therefore it 

can only function correctly with reading blocks having 
the length of 4005 chrts. 

In case of different length, it must be recompiled 
changing definition of the reading area”. 


-GAS - Particular rules 


"Provide loading in the file of a fictitious program 
having code YYYYYYYY which might be formed by anyone 
card. If this program is not present, it is not possible 
to execute the check of the last program existing in the 
file or substitute the last card. 
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COBOL MANUAL 


- EDOS Order Card 


Parameter DV=50 has been inserted for DSU150 discs. 
Only parameter DV=57 is mandatory in case of programs with 
sequential file with index to be executed in DSC157 

re) environment. 


- Considerations on source program compilation 


It must be added that: the user may optionally eliminate 
the COBOL wourse program listing by loading characters NL 
(.UAL, NL) in the USER AREA. 


+) - Character P 


In addition to what has been said in the manual, it must 
be pointed out that the COBOL compiler does not allow 
the use of character P when using Editing characters. If 
used they are not detected by the compiler. 


° Beside the end of compilation messages described in the 
manual, during execution of COBOL compiler, the following 
signals may be printed: 
1) COMPILATION NO POSSIBLE PERSISTENT ERROR ON WORK TAPE 
cause : hardware error on tape 


effect : hait 


2) COBOL CARD INCORRECT COMPILATION NO POSSIBLE 


cause : 1, different character from I or ¥ in col. 72 
of .COBOL card 


2. "D" in col. 9 and "T" in col. 11 of .COBOL 
card 


3. "T" in col. 11 and % or number smaller than 4 
in col. 72 of .COBOL card 


effect : halt 


3) FILE "SOURCE-COBOL" NOT PRESENT 
Cause : no file on disc has the name SOURCE-COBOL 
effec : halt 
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4) PROGRAM "XXXXXXXX" NOT PRESENT 


cause 


effect : 


the program name specified in the .COBOL card 
does not correspond to any source program on disc 


halt 


5) NEXT IN . TAPE 


cause 


effect 


the last record is found on the tape reel 
of the source program (!!! in the first three 
characters of a record) 


the tape reel is rewound 

There is a halt so that the operator can mount 
the following tape reel. 

The compilation sheet jumps to new page where 
the heading is printed. 

Processing continues with reading of source 
record from tape. 


6) INPUT TAPE SOURCE PROGRAMS END 


Cause : 


effect 


end of tape condition is found (UF/OF=1 and 
ZE=NZ=1) after the first try to read a record 
on the source program tape, 


the tape is rewound. Segment 2 jumps to Halt 


-02A6 of Operating System. 


Med, 0502 fT 
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7) COMPILER ERROR SEGMENT LU 

cause : formal controt on file "0" does not detect 
the presence of a record with code "OD" (Trailer 
REPORT SECTION) or B3 (Initial Procedure Division). 
processing of the compiler stops at Hlt 0674 of 
the Operating System. 

8) NO MESSAGE - HALT ONLY 

cause : More than 374 errors have been found 

effect : compiler stops at hexadecimal address OE8A 
If START is pressed no further errors are 
signalled. 

9) COMPILER ERROR SEGMENT RT 

cause : a record on file "0" has a record code not 


allowed among beginning and final records of 
REPORT SECTION, which have codes OD and FD 


effect : processing of the compiler stops at Hlt 0674 of 
the Operating System. 
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COMP. ERR. 


during macro generation, the compiler finds 
a code of macro instruction non valid. 
XX is the non valid code. 


effect error message is printed, the compiler continues 
with the following character of Macroinstructions 
Table, 


11. COMPILER ERROR SUBR. OMITTED 
cause : during searching of a COBOL subroutine, the 


correspondent is not found in a table of the 
compiler. 


effect : error message is printed, processing continues 
with the following subroutine. 


© 
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SYSTEM [ l 


| 


12, HEADER : "ERROR MESSAGES" 
MESSAGE: "SUB. YNNNNN MISSING" 


cause : after having examined the library of system 
: subroutines, the YNNNNN subroutine is missing 


effect : processing continues with following subroutine 


13. WORKING - STORAGE OVERLAYS PROCEDURE - DIVISION 

cause : final address of the object program of a resident 
or independent segment is greater or equal to the 
starting address of the WORKING STORAGE 


effect : .compilation is not valid, halt at O2A6. 


4. SUBR. YXXXX OUT OF SEQ. (COMPILER ERROR) 


cause : a main subroutine, when compiling the hook to a 
called one, finds out that the latter has not 
been assembled. 


effect : address 0000 is assumed, processing continues 
and at the end the compilation is not valid. 
It stops at L2A6. 
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5. SEGMENT OVERLAY START ADDRESS WRONG 


it may occur when the non resident segment overlap 
partially the resident segment. 


cause : incase of segmentation the start~address of 
the non-resident segment, calculated in the 
assembling phase, does not coincide with the 
same address calculated before the assembling. 


effect : processing goes .on but compilation is not 
valid since the address assumed by the 
compiler is wrong. 
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Compilation of a source program 


Beginning order card for ETOS 


Column 11 B the source program is on cards 
T the source program is on tape 


Paragraph a. “RD Report Description Entry" 


5. A program may contain more REPORT WRITER. [f a page skip is 
required between one REPORT and the other, the OPEN and CLOSE 
of the printer file must be performed for each REPORT. 


Paragraph 3. " Listing of error messages" 


Message 511 VERB CONFIGURATION NOT ALLOWED 


Cause : There are’ inconsistencies in the 1/0 operations or 
1/0 operations are not performed on that file. 


Effect : Compilation is invalid. 
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TAB _EDOS 


The TAB compiler, during biprogramming adaptation, underwent 
modifications and implementations some of which were extended to 
the order card .TAB and card x» (first card of GENERAL DIVISION). 
The order card common to programs written according to both TAB2 
and TAB3 format has been modified as follows: 


-TAB, AT = = » PROG. NAME, CM = COMMENT 


1 
-TAB, AT = Ny SP-& Z » PROG. NAME, DV=157, NL, CM = COMMENT 
0 


It may be noted that two new options have been introduced. 


1) DV = 157 
2) 


a) The first is expressed when the disc units handled by the 
object program are A DU 157. 


b) The second one when the APS list of the translated program 
is not requested. 


The card x (first card of GENERAL DIVISION) in TAB 3 format has 
been modified in cols. 35-46 according to partitions listed below. 


a) 35-39 reserved to the address (optional) that the user wants 
to use as beginning of the object program. 


b) 40-41 reserved to memory capacity (mandatory) in which the 
program will work; it is expressed in modules of 4K 
memory from 01216. 


The TAB compiler, in translation phase, examines the contents of 
such field and at the end it will load automatically the .APS or 
-DAPS order according to what has been detected; namely .APS for 
values up to 08 (32K), .DAPS for greater values. 


c) 42246 reserved to the third operand that the user will express 
on the STRT card generated by .APS and .DAPS and may 
contain CTWBB, SPOOL, absolute address expressed in 
decimal (OPTIONAL). 

SPOOL 


Ex.: 
STRT 08000, 08, CTW 
20.000 
1) CTWKK expressed when the presente of the xMSG routine 
is required for CTW subsystem. 
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SPOOL (valid for biprogramming'only) expressed if 
signal M is to be printed at the overflow of the 
final part of the memory; last 4000 positions where 
part of the supervisor ts residing. 


ABSOLUTE ADDRESS (5 decimal feagures) 
shown if signal M is to be given at the exceeding of the 
expressed address. 


The same modifications were made to card x for programs written 
in TAB2 at cols. 50-61. 
Positions 50:54; 55+56, 57:61 correspond to 

35239; 40241, 42:46 above described for TAB3 format. 


NOTE 


In Spooling-Alternance-Coexistence environments the arder card must 
be introduced in memory, controlled by the reader, because if 
introduced by CTW the automatic loading of the order .APS, set 

in memory by TAB compiler, would be inhibited. 


‘Mod. 6902/1 
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1. HARDWARE characteristics 


The study of hardware characteristics of the VIP 700 terminals 
(manual ref. 15-20-007-A) should take place before reading this 
manual. 


The software for the G 100 - VIP 700 connection can handle up to 
32 DCU (Display control unit) and up to 64 VIP 775 terminals 
or 32 VIP 785 terminals. 


1.1 The SLC 114 line controller 

Through the SLC 114 unit, the connection is performed in 
synchronous mode only, half duplex at a speed of 1200, 2400 or 
4800 bauds. 


The transmission code is 180 : 7 bits + 1 (the compression- 


r 
expansion ratio for the SLC 114 is : bit ® = bit Lae 


For additional information make reference to the manual on SLC 100 
data transmission devices (ref. 32-23-002 F). 


1.2 Lines and modems characteristics 
A communication network can be used having the following 
characteristics: 
- short distance: 15 meters : direct line 
- tong distance: telephonic Tine that may be either a: 
. Switched line : which is a user private’ tine or a 


. Leased line : which is leased from the local Telephone Company 
and can be a 


1200 bauds line.(2 wires) or 
2400 or 4800 bauds line with 4 wires and higher 
reliability 


Modems can be having the following characteristics: 


- synchronous duplex:1200 bauds 
- synchronous duptex 2400 bauds 
- synchronous duplex 4800 bauds 
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1.3 The VIP 775 terminal 


The VIP 775 terminal allows to exchange messages for the maximum 
length of 1012 characters (22 lines of 46 characters each). 


1.4 The VIP 785 terminal 


The VIP 785 termina? altows to exchange messages for the maximum 
length of 2024 characters (22 lines for 92 characters each). 


1.5 The teletype terminal 


VIP 700 terminals can be simultaneousty connected with a teletype 
{TTY 33 or Terminet) and get the message printed out either 


- in a local mode: through a direct message switch from VIP 700 
to teletype, without using the computer system, or: 


- in a computer controtted mode: using the computer system to 
transfer the message content from the VIP 700 to the teletype. . 


Messages from the computer system can be printed out directly 
on the teletype. 


Teletype: TTY 33, 10 characters per second 
Terminet 300, 10 or 15/20 or 30 chrs. per second 


Remark : one teletype can be connected through DCU. 


2. SOFTWARE characteristics 


2.1 General remarks 


The VIP 100 software package can be introduced into the EDOS 
library to handle VIP 775 and 785 terminals through the 
synchronous line controller SLC 114. 


The VIP 100 software provides with an interface between 
programs and terminals. 


Either message receiving and message sending operations 
handled by the VIP 100 software. 
The user will only have to: 


fill the general polling table with the values for the parameters 
requested by the subroutiness 


fill a terminals table with the parameters requested for each 
terminal; 


fill another terminals table, used for the job start-up; 
write down the calling sequences for the terminal management 
routines; 
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define a blocking area that will be used by the software; 


provide for a message area where the message content will be 
stored after having been received and where the message will 
be prepared before sending it to the terminal. 


2.2 System configuration 


The VIP 100 software works in a standard EDOS environment. The 
oO minimum configuration required is then the same requested by the 
EDOS operating system. 


Obviously a SLC 114 line controller has to be added to that minimum 
configuration, in order to physically handle the transmission line. 


Either EDOS I/II (Monoprogramming) or EDOS IV (alternance/cdexist- 
ence) is suitable for usage of VIP 100 software. 


The VIP 100 package handies VIP 775 and VIP 785 terminals either 
with or without hard copy provision (teletype). The allowed 
° transmission sp-eds are 1200/2400 and 4800 bauds. 


2.3 Package structure 


The VIP 100 package is made up of 6 subroutines that will be 

described in details. The user will have to provide the calling 

sequences for the subroutines that he wants to have assembled 

into his program. As a matter of fact, the VIP 100 subroutines, as 
C*) any other subroutine, are optional and are factored into the 

object program only when the user has required their inclusion. 


2.4 Subroutines description 


2.4.1 YPOLG General polling (65 characters) 


This subroutine polls all terminals to request a message 
transmission, 


2.4.1.1 Subroutine characteristics 


By this subroutine, the. terminals table is scanned as many times 
as required and each operational terminal receives a request to 
send a message. 


After having performed the required number of scannings without 

° positive answer from any terminal, the program control goes back - 
from the routine to the user program, using the return address: 
"no message sequence". This way the user will be able to know 
about the actual situation. 
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If a positive answer comes from a terminal, the subroutine will 
contro] the transmission operations from that terminal and will 
make the message available to the user in the message area which 
has been defined in the polling table. 


The polling process will go on with the terminal next to the one 
which has just transmitted and will not go back to the first 
terminal of the table. 


Remark : Polling will not consider those terminals that are not 
in “operational” status. 


2.4.1.2 Calling sequence and parameters 
xPOLG AAAA,BBBB,CCCC 


Parameters description: 


AAAA : is the number of scannings that are to be performed on the 
terminals table before giving the control back to the user 
program through the return address "no message sequence". 
Scanning can be requested for a number of times ranging 
from 1 to 255. 


: represents the return address to the user sequence when 
no message has been received and the requested number of 
scannings has been performed. The "no message sequence" 
has to be provided by the user. 


cccC : is the General poliing table address 


When assembling, above macro will be expanded into the following 
sequence: 


YPOLG 

AL2 (AAAA) scannings number 

AL2 (BBBB) return address for no message sequence 
AL2 (CCCC) General polling table address 

regular return in case of message received 


2.4.1.3 Messages reception 


The message received from the terminal wil] be made available 
in the user-defined message area according to the format: 


WES AES. 


N 

DIK| T/C{CcyT 

c}D 

UJ T) A} 1] 2) X |<—————— TEXT ——_———_> 


left address 
MSG user-defined area 
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message text length-1 expressed in 
binary representation (service and 
length characters are not included) 


character DCU number (Hexadecimal representation) 
character transmitting terminal number 
(hexadecimal representation) 


VIP 775 


KOT 1 EO 

f KDT 2 E& 

Status VIP 785 EO 

FCl character function code (alphanumeric) 

FCc2 character function code (alphanumeric) 

STX character beginning text mark (02 in hexadecimal) 


Text characters text length is provided in the first 
two service characters 
(text is in alphanumeric) 


Remark : No information can be stored into the message area. 
The message area content is modified even though no 
message has been received from terminals. 


2.4.2 YPOLD One terminal polling (61 characters) 


This subroutine enquires for possible message transmission one 
defined terminal. 


2.4.2.1 Subroutine characteristics 


This subroutine makes a request, to the terminal for a message 
transmission. 


If the terminal is ready to send a message, the message content 
will be made available to the user in the Message area defined 
in the polling table. The control wilt then be given back to 
the user program through the regular return. 


On the other case, when the terminal has no message to be sent or 
if it is not operational, the control will be given back to the u 
user program through the address : “no message or terminal out 
sequence". 


2.4.2.2 Calling sequence and parameters 


«xPOLD AAAA, BBBB 


where AAAA represents the address of the terminal table 
BBBB- represents the user-routine address for “ 
message or terminal-out situation" 
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After the assembling process, the above macro will have been 
expanded into 

ORT YPOLD 

oc AL2 (AAAA) terminal table address 

Dc AL2 (BBBB} no message/terminal out user-routine address 
seas regular return when message has been received 


2.4.2.3 Message reception 


After the message being transmitted, the message content will be 
stored in the user Message Area under the following format: 


N 
D 
Cc 
U 


: refer to point 2.4.1.3 for the description of above table. 


2.4.3  YSELC terminal selection (114 characters) 
This subroutine provides for sending a message to one terminal. 
2.4.3.1 Subroutine characteristics 


The YSELC subroutine selcts the terminal which corresponds to the 
address given in the terminal table under parameter from. 

However, if the provided parameter is 00, the last polled terminal 
will be selected. 


Under user control, the message can be visualized either on the 
terminal CRT display or on the teletype. The user will have to 
indicate it through a given value to the parameters and then the 
subroutine will select the required support. 


When the terminal is out or not operation yet or simply busy, the 
return address from the subroutine to the program will be: 
“Terminal out sequence". 


The user will identify the different possible situations by 
testing the UF/OF and ZE/NZ registers. 
UF /OF ZE/NZ 


J 0 the terminal is out or non operation yet x'20' 
1 1 the terminal is busy x'10' 


Remarks : 1. two selections of the same terminal must have in 
between a direct polling on the same terminal. 
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2. when the selected terminal is busy, the message has 
not been handled by the software and has to be resent 
by the user (keeping in mind the remark n. 1). 


2.4.3.2 Calling sequence and parameters 


+*¥SELEC AAAA, BBBB, CCCC, DDDD 


where AAAA provides the Terminal table address. If the 
indicated value is 00 the selected terminal 
is.the last potted one. 


BBBB identifies the required support 
00 = CRT display 
01 = teletype 

CCCC gives the address of the user program sequence to 
be performed when the terminal is out or not 
Operational yet. 


DDDD gives the address of the generat polling table. 


During the assembling process, the following statements will be 
generated from the above macro: 


ORT = YSELEC 

oc AL2 ania terminal table address or 00 

DC AL2 (BBBB) BBBB is 0000 if the message has to be visualized 
on CRT display 
BBBB is 0001 if the message has to be printed 
on teletype 

oC AL2 (CCCC) address for user routine When the terminal is 
out or non operational 

AL2 (DDDD) General polling table address 

regular return 


2.4.3.3 Preparing the message to be sent 


Information that has to be sent is stored by the user into the 
Message Area according to the following format: 


1 
Wesanee| | 
(TEXT. ooo _ TEXT | 
tare address of the 


MESSAGE user-area 


LL-1 2 characters is the text length-1 in binary representatio 
TEXT n characters is the text of the message.to be sent 
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2.4.4 YDELET Terminal deletion (55 characters) 


This subroutine puts a terminal in non-operational status. 


2.4.4.1 Subroutine characteristics 


By this subroutine a terminal can be eliminated from the 
communication network for a given period of time : this means 
either for a given number of polling turns from OT to 255, or 
until a new direction is provided. in this second case the 
terminal will be set back to the "operational" status through 
the macro "YRESTO". 


This subroutine provides for a logical deletion (non physical). 


Remark : when a terminal is temporarily deleted for a given number 
of pollings, it will be automatically reset to the 
Operational status after the requested number of pollings 
has been performed. 


However, the user thas the option to reset it back to the 
Operational status before the deletion time is expired 
(see YRESTO) 


2.4.4.2 Calling sequence and parameters 


- XDELET AAAA, BBBB 


where AAAA gives the address of the parameters table for 
the terminal to be deleted 


BBBB_ represents the deletion parameter : 


O for a final deletion 

1 to 255 indicates how many scanning turns have 
to be performed considering the terminal in 
"non operations?" status. 


During the assembling process, the above macro will be expanded 
into the following statements: 


JRT YDELET 
pc AL2 (AAAA) terminal table address 
oc AL2 (BBBB) deletion parameter 
O = finat 
1 to 255 temporary deletion : scanning turns 
regular return 
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2.4.4.3 Terminal deletion using a CTW or card reader 


-_EDOS I environment : A card reader can be used to control the 
terminal deletion. In order to do that the 
user has to put the "card reader controlled 
DELET and RESTO" code into the General 
polling table. 

In this case the card reader cannot be used 
for other purposes (like card files reading 
etc.). 


The indicated procedure must be followed to delet a terminal 
using a card reader: 


- a parameters card has to be punched according to the required 
format (here below) 


- the punched card. has to be put into the card reader 
- the card reader must be set to the operational status 
- EDOS II or IV environment : a CTW device can be used for deleting 


a terminal following the procedure here 
indicated: 


- push the INPUT on the CTW (in EDOS IV 
environment type xUPx) 


wait for the xVIPx GO TYPE message being 
printed 


type the message according to the format 
indicated here below 


type the end-message code "ETX" 


. Parameters format 


DELET, AAAA, BB, CC, DDD 


where AAAA represents the address (in hexadecimal representation) 
of the table for the deleted terminal 


BB gives the DCU number for the terminal 
ce gives the terminal number and, 


provides the deletion parameter: 
000 for final deletion 
001 to 255 for temporary deletion 


Remark : The message under transmission is controlled as far.as 
message format and consistency are concerned. The message 
which is not found correct is printed with the comment 
"ERRONEOUS" on the CTW in EDOS II or IV environment or on 
the system printer in EDOS I environment. 
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2.4.4.4 Actual execution of the macro 


Any time a terminal is deteted, record will be kept through a 
printed message on the system printer in EDOS I environment or 
on the CTW in EDOS II or IV environment. 


The message content will be : 

xVIPXDELET DCU : XX KDT : XX DEFINITIVE 

or 

RVIPXDELET DCU : XX KDT : XX for xxx SCAN 

Remark: The addresses of the terminal tables, the DCU's and 
terminals numbers are printed during the execution 


of the YOPNY subroutine. This way the computer operator 
will have all information available. 


2.4.5 YRESTO Terminal inclusion (49 characters) 


By this subroutine a terminal is put in an operational status. 
2.4.5.1 Subroutine characteristics 


A terminal that either had been eliminated from the network through 
a YDELT statement or had been left out at start-up time, can 
be set to operational status by this subroutine. 


Remark : If the terminal is already actually operating, the 
subroutine execution will have no effect. 


2.4.5.2 Calling sequence and parameters 


x RESTO ARAA 


where AAAA represents the table address for the terminal to 
be included 
During the assembling process, the above macro will be expanded 
into the following sequence: 
JRT YRESTO 
oc AL2 (AAAA) Terminal table address 
regular return 


2.4.5.3 Terminal inclusion using a CTW or a card reader 


Procedures and instructions to use these features are the same as 
for the YDELT subroutine. Reference has to be made to point 
2.4.4.3 for details. 
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~ Parameters format 


RESTO, AAAA, 8B, CC 


where AAAA gives the table address for the terminal to be 
included (hexadecimal representation) 


BB represents the DCU number for this terminal 
(hexadecimal) 


cc represents the terminal number 
; as in the case of the YDELET subroutine, the message 


is checked for consistency and if it is found not 
correct it will be printed with the comment "ERRONEQUS" 


2.4.5.4 Subroutine execution 


Any time a terminal is included into the communication network a 
message is printed on the system printer in EDOS I environment or 
on the CTW in EDOS II or IV environment. 

The message text is : 

xVIPx RESTO DCU : XX KDT : XX 


Remark : the terminal tables addresses, the DCU‘s numbers and the 
terminals numbers are printed when the YOPNV subroutine 
is executed. 


2.4.6 YOPNV system start-up (637 characters) 


This subroutine sets up all parameters and tables at the beginning 
of the job. 


2.4.6.1 Subroutine characteristics 


The system start up functions performed by the YOPNV subroutine 
are necessary only once when. beginning the job. The routine can 
then be overlaid during the program execution. Key functions 
performed by this routine are the following: 


set the general polling table to initial conditions 
set the terminals table to initial conditions 


put in "operational" or "non-operational” status the terminals 
according to the situation given by the user inthe terminal 
start-up table 


control 


provide for the buffers on disc for the message retransmission 
if necessary. 
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« The buffer on disc 


If it is necessary to resend a message, this must have been 
stored on disc. It’s the task of the YOPNVY routine to compute the 
sector address for each buffer (one for each terminal). The 
address is calculated according to the place available in the 
free areas table of the volume indicated through the second 
position of the general polling table. 


Each buffer on disc fills 8 sectors. 


The user has then to define a file FILEVIP. If the file does not 
exist on the work disc or if there is no space available on the 
indicated volume, the YOPNV subroutine will stop on a halt 
instruction after having printed this message: 


xVIPx FILEVIP UNKNOWN OR OVERFLOW 


2.4.6.2 Calling sequence and parameters 


XOPNV AAAA, BBBB 
where AAAA represents the address of the general polling table 


BBBB represents the address of the start-up terminals 
table 


When assembling, the above macro will be expanded into the following| 
sequence: 

JRT  YOPNV ; 

oc AL2 (AAAA) general polling table address 

oc AL2 (B8BBB) ‘start-up terminals table address 

tease regular return 


2.4.6.3 Subroutine execution 


At the system start up time, a message is printed through the 
terminal. This message gives all necessary information to control 
the execution of DELET and RESTO macros through an external support. 


xVIPxDCU : XX KDT : XX ADDRESS : XXXX ENABLE 

or : 

xVIPxDCU : XX KDT : XX ADDRESS : XXXX NO ENABLE 

where 

DCU : XX XX represents the DCU number (hexadecimal) 

KDT : XX XX represents the terminal number (hexadecimal) 


ADDRESS : XXXX XXXX.represents the terminal table address 
(hexadecimal) 
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ENABLE if the terminal is in operational status 
NO ENABLE if the terminal is in non operational status 


2.4.7 YSPBSY (3343 characters) 


This subroutine is called by the following 5 subroutines: 
YDELET . 

YRESTO 

YPOLG 

YPOLD 

YSELEC 


The YSPBSY subroutine handles the physical message transmission 
and reception, the transmission/reception contro, the translation 
tables, etc. 


2.5 The Tables 


The VIP 100 software uses 3 types of tables: 

~ a general polling table 

- a terminals table 

- a table for the terminals to be set-up at start up time 


2.5.1 The general polling table 


This table provides general information. 

It must always be located in the resident program segment. 

Its length is 39 characters. 

The first 13 characters of the table contain information to be 


provided by the user; the following 26 characters will instead be 
used by the software as service area. 


Characters to be given by the user : description 


Characters : Description 
zero binary 
Service disc logical number (decimal) 
LL-1 of the Blocking area (binary) 


The length of the Blocking area has to be computed 
as follows: 


Blocking area length = length of the longest 
message + 22 times the number of terminals + 50 
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Characters Description 


5-6 Left address of the Blocking area (hexadecimal) 
7-8 LL-1 of the user message (binary) 


The length of the user message area has to be 
computed as follows: 


message-area length = length of the longest 
Message + 24 


Left address of the user message area 
(hexadecimal) 


Central memory cycle (hexadecimal) 


20 for a G 130 
30 for a 6 120 
40 for a G@ 118 
00 if direct line (without modem) 


Line speed (hexadecimal) 


12 if 1200 bauds 
24 if 2400 bauds 
48 if 4800 bauds 


Parameter for the card reader (decimal) 


O = Utilization in EDOS II or EDOS IV or in EDOS I 
environment without CTW. RESTO - DELET sub- 
routines using the card reader 

1 = Utilization in EDOS I environment when the 
subroutines RESTO - DELET are controlied 
through the card reader 


14-39 Zeros binary 


2.5.2 Terminals table 


This table is made up of one table for each terminal and ends up 
with two FF characters (hexadecimal). Each terminal table has a 
length of 20 characters. The user has to give the information about 
the first 2 characters and the 13th and 14th characters. The other 
characters will be used by the software as service area. 


Important : This table must physically follow the general polling 

table and has to be located in the resident program 
segment. 
The DCU numbers must be in progressive sequence and, 
even though two terminals are connected to the same 
DCU, the terminals numbers have to be in progression 
too. 
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Characters to be given by the user : description 


Characters Description 
1 no. of the DCU (hexadecimal) from 00 to IF 
2 no. of the terminal (hexadecimal) 
VIP 775 {Eo if KDT 1 
fE8 if KDT 2 
- VIP 785 £0 
zeros - binary 
Terminal type 
1 = VIP 775 or VIP 785 
ih 
3 d= not used 
4J 
15 Controller connection number (hexadecimal) 


2.5.3 Table of terminals to be set to operational status 


This tabie gives the table address for those terminals to be put 
in operational status at start-up time with the OPNV subroutine 
execution. 


This table can be loaded into the open: segment. 
This table must end up with two FF characters (hexadecimal). 


Important : The addresses of terminals to be put in operational 
status must be in progressive sequence. 


3. EDOS II and EDOS IV environment 


The control on the type of operating system is within the purposes 
of the YOPNY subroutine. 

When in a EDOS II or IV environment the subroutine customizes the 
other routines in view of the usage of a CTW 101 instead of the 
system printer. 

In EDOS IV environment the YOPNV subroutine will use the regular 
xUP macro to assemble the particular subroutine required by the 
VIP 100 software for the CTW 101. 
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4, Diagnostic utilization 

For start up or maintainance there is a diagnostic function - 
easier than a user program - which allows printing of all messages 
exchanged between the terminal and the computer. 


Note: This function may be used both in EDOS I and EDOS II with 
SWITCH 2 ON to allow message printing. 


The messages are printed in the following way: 
1) Polling 


_ HEADER, MESSAGES 


—— a 
A 
Ea 


| 100 characters | 


2) Selecting 
MESSAGES 


ur-1l 
| 
| 


— 100 characters 


| 


9.17 


a 
oOo 

uapead Burtsoqs. 
paeg S4a3siBay KN & 


BILAUBS JO yno 
do abessow 


ayoko dL ssauppe 
“OW . Asqua-ay 


paeds auLy a 


not used 


0= 


eaue 
abessoy 


ssauppe Aaqua-o4 weaboud 
3327 gO Ssauppy 


eaue 


Am 
abessay 1 


40 addL 
Lea sBuluueos 
$o saquny 


2400 Bauds 
4800 Bauds 


eaue YOoLg a/4 
Bur,_od svapun 

ssauppe : 
ae ssauppe alqey 
1g4 4s5e4 

eaue YOOLg 

y/Bur pod dapun 
SSeuppe @1qeqy 
Lay 7se7] 


binary 


11 


vaqunu 
21601 aM 


ATTACHMENTS 


Aaeurg 
00 


ssauppe 
arqe? La 


< 
° 
- 
» 
= 
co 
oO 
a 
o 
7s 
o 
a 
rj 
ney 
o 
= 
- 
[= 
a 
© 
£ 
o 
c 
oO 
(5) 
Lo 


hexa dec. 
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5.2 Terminals table description 


Each terminal table 


unit number 
b 
A = ACK sector number 


NACK not loaded 
EO if KDTI BUSY already loaded 
£0 if KDT2 Select 


WIP 785 = £0 Poll without reception eee pers 


Poll, acknowledging reception 


( 
WP ‘a 


operational 
non operational 
temporarily non operational 


Binary zeroes 


ype of 
terminal 
SLC connec. 


T. 
> 
° 


1 = VIP 775 or VIP 785 
2 
3 7= not used 
4 
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sa) |i Pees ese | 


Terminals table 


° 


FFEF 


Ist KDT table 2nd KDT table nth KDT table ene 
chrt. 


Remark : 
The terminals table is made up of as many tables, one for 
each terminal, as the terminals in the system. 
(+) The terminals table ends up with two FF characters 


The terminals table must be immediately next to the general 
polling table. 


°o 5.3 Start-up terminals table 


able address 
for the Ist KDT 


o be put into 


operational 


status 
able address 


T 
= 
a 
vf 
an 


Table address 
for the 2nd KDT 
for the nth KDT 


seb eboas se. 


Remark 


. Addresses for the terminals to be set to operational status 
must be given in ascending sequence 


. The table must be ended out by two FF characters (hexadecimal). 


G82 dIA 4! 04 
@ Lay GZ dIA 4! 84 7p SSe4ppe Lay 
L Lay GZZ dIA 3! 04 


Filsuedg OF 


e 


uoltydacau ASA 

1 AOVN 

Bur Bpa_mouxoe Soy 

. a adf7a184=1d 


structur 


ssauppe ay 
1d 


yeu pus 
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LG AX Xf2]lyv HI) [x] 2] LT yay Xx XJOPLIVJY THIN IN INN 
off. |axas}t oo] oY [4919/1 ]0)9 LJLXALILPIPIPLIGPOP APA TAT Al. 
FIZZE S$ js jsts s(Zla Isl alalslyis a SJsSfspS]VIS}S{SIS|[S) 


fT CEOS $6!#’WT/""“’” 
ax07 obessay quawabpaymouyoy Topssjusueay BbeSSON (q 
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SS@4ppe wal Louquod. ssauppe dal [ouzuod 


Pron] 
HEE 
[+] 


UOLzoaLasS Ad{LOAqUog (e WOLZIeLasS sa_[oaquo) (e 
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5.5 DCU Address in Polling and Selecting mode 


a) DCU address in Polling mode 


DCU number from 00 to 1F 


Ree Sa 


address character 


Polling DCU address from 20 to 3F 


b) DCU address in Selecting mode 


27 26 25 a4 23 22 


ee~_—_—’"_ 
DCU number from 00 to 1F 


address character 


Selecting DCU address from 40 to 5F 
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5.6 Macros summary 
a) YDELET terminal deletion 
DELET AAA, BBB 


AAA = terminal table address 


BBB = deletion parameter O final 
1 to 255 if temporary deletion 


b) YRESTO terminal inclusion 


RESTO AAA 
AAA = terminal table address 


c) YOPNV system start-up 


OPNY - AAA, BBB 
AAA = general polling table address 
BBB = start-up terminals address 


d) YPOLG general polling 


POLG AAA, BBB, CCC 
AAA = scannings number (12 to 255) 
BBB = return address for no. message sequence 
cce general polling table address 


e) YPOLD one termina? polling 


POLO AAA, BBB 
AAA = terminal table address 
BBB = no message/terminal out user-routine address 


#) YSELEC terminal selection 


» SELEC AAA, BBB, CCC, DDD 
AAA = terminal table address or 00 


BBB = 00 if the message has ta be visualized on CRT 
display 
O01 if the message has to be printed on teletype 
ccc address for user routine, when the terminal is out 
or non operational 


DDD = general polling table address 
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Registers: UF/OF ZE/NZ 


1 0 the terminal is out or non 
operational yet 


al 1 the terminal is busy © 
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Q3gs£ ISel Onno S022 4 bal*L beLE g90L nano Oseo2 & 10909°L 
oon2 34390 0000 Lozsé tL avi’. 22Lb 390L anno OnLss ¢ yod*h 
3942 RL6b 0000 Loes2 ¢ SdS°L 2492 a¥¥O naond ne7g2 ¢ Oduel 
4ags 24tb 0000 anges 4 voded 9082 9600 onnd C?C49 L dash 
3342 acal 0000 2G?le b HOSEL o0nk 32¢L anno aces b Vdet 
bvél RaSk on00 alesse § dsuee d92L 9960 N00 so2ck tt Jaret 
9342 ZRYL = an00 G2Lb2 L yiSeL voss vaslL anand ALS? 4 g9Let 
232 ASZL OOO0 0Ne! 4 JOL*L R292 347L nano SnAPs & solel 
Ji2e vost 0nnO snn2d 4 daley 3492 YORE fond PA702 b Nat 
ORa2 ARGL 000 76207 b Hakee 4902 O26 no00 SoLa2 L WLiT°L 
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g3a0 #360 On00 722a9 b JES*L ago2 ogvan none unsao kb Qdare 
0042 93460 000 ca2ao 1 adgeb g692 2380 Anand RYSRO L ddseb 
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